利用 Django 2.0 构 建 强大 、 可 靠 的 Web 应 用 程序 
Django 
项 目 买 例 精 解 ,ss， 


VS 


™ 
和 


Blango'2 by Example Em 


Django 项 目 实 例 精 解 
(第 2 版 ) 


[ 美 ] 安东尼 奥 。 米 勒 著 
李 伟 译 


内 容 简 介 


本 书 详细 阐述 了 与 Django 开发 相关 的 基本 解决 方案 ， 主 要 包括 构建 博客 应 用 程序 、 利 用 高 级 特性 完 
善 博客 程序 、 扩 展 博 客 应 用 程序 、 构 建 社 交 型 网 站 、 共 享 网 站 中 的 内 容 、 跟 踪 用 户 活 动 、 构 建 在 线 商 店 、 
管理 支付 操作 和 订单 、 扩 展 在 线 商店 应 用 程序 、 打 造 网 络 教 学 平台 、 显 示 和 缓存 内 容 、 构 建 API、 部 署 
项 目 等 内 容 。 此 外 ， 本 书 还 提供 了 相应 的 示例 、 代 码 ， 以 帮助 读者 进一步 理解 相关 方案 的 实现 过 程 。 

A 也 可 作为 相关 开发 人 员 的 自学 教材 和 
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译 者 序 


Web 开发 是 Python 语言 应 用 领域 的 重要 部 分 。Python 作为 当前 最 火爆 、 最 热门 ， 也 
是 最 主要 的 Web 开发 语言 之 一 ， 在 其 发 展 过 程 中 出 现 了 数 十 种 Web 框架 。 其 中 ，Django 
是 一 个 功能 强大 的 Python Web 框架 ， 支 持 快 速 开发 过 程 以 及 简洁 、 实 用 的 设计 方案 。 

由 于 Django 在 近年 来 的 迅速 发 展 ， 其 应 用 越 来 越 广泛 ， 同 时 也 被 认为 是 该 领域 的 佼佼 
者 。 本 书 在 Django 2.0 的 基础 上 引领 读者 构建 真实 的 Web 应 用 程序 ， 其 中 涉及 Redis 和 
Celery 等 技术 、 开 发 插件 式 Django 应 用 程序 、 优 化 代码 并 使 用 缓存 框架 、 向 Django 项 目 
中 加 入 国际 化 特性 、 利 用 JavaScript 和 AJAX 丰富 用 户 体验 、 添 加 社交 功能 ， 以 及 针对 应 
用 程序 构建 RETSful API， 而 这 一 切 均 通过 颇具 研究 价值 的 项 目 实例 的 方式 予以 展现 。 

在 本 书 的 翻译 过 程 中 ， 除 李 伟 外 ， 张 博 、 刘 璋 、 王 烈 征 、 刘 晓 雪 、 刘 神 、 张 华 臻 等 人 
也 参与 了 部 分 翻译 工作 ， 在 此 一 并 表示 感谢 。 

由 于 译 者 水 平 有 限 ， 难 免 有 下 漏 和 不 妥 之 处 ， 奶 请 广大 读者 批评 指正 。 


了 中 


前 


Django 是 一 个 功能 强大 的 Python Web 框架 ， 支 持 快速 开发 过 程 以 及 简洁 、 实 用 的 设 
计 方 案 。 无 论 是 对 于 初学 者 还 是 专家 级 程序 员 ， 这 一 特点 颇具 吸引 力 。 

本 书 将 引领 读者 学 习 专业 Web 应 用 程序 的 开发 流程 。 除了 框架 知识 之 外 ， 本 书 还 将 
解 如 何 将 其 他 较为 流行 的 技术 整合 至 Django 项 目 中 。 

本 书 将 讨论 真实 应 用 程序 的 构建 过 程 、 常 见 问题 的 处 理 ， 并 逐步 实现 多 种 最 佳 实践 
方案 。 

在 阅读 完 本 书后 , 读者 将 能 够 理解 Django 的 工作 方式 , 以 及 如 何 打 造 具有 实用 性 的 高 
级 Web 应 用 程序 。 


适用 读者 


本 书 是 针对 具备 一 定 的 Python 知识 ， 同 时 希望 以 一 种 实用 的 方式 学 习 Django 的 读者 
而 准备 的 。 或 许 ，Django 对 于 读者 来 说 是 一 项 全 新 的 事物 ， 抑 或 ， 读 者 对 此 稍 有 了 解 且 希 
望 进一步 学 习 Django。 通 过 打造 实用 的 开发 项 目 ， 本 书 可 帮助 读者 掌握 大 部 分 架构 知识 。 
另外 ， 本 书 要 求 读 者 对 某 些 编程 概念 有 所 了 解 ， 同 时 具备 一 些 HIML 和 JavaScript 方面 的 
知识 。 


本 书 内 容 


第 1 章 通过 编写 博客 应 用 程序 向 读者 介绍 框架 知识 。 其 间 ， 我 们 将 构建 基本 的 博客 模 
型 、 视 图 、 模板 以 及 URL 以 显示 博客 内 容 。 另 外 ， 读 者 还 将 学 习 如 何 利用 Django ORM 构 
建 QuerySets， 并 配置 Django 管理 网 站 。 

第 2 章 将 讨论 如 何 处 理 表单 问题 利用 Django 发 送 邮件 以 及 第 三 方 应 用 程序 的 整合 操 
作 。 读 者 将 尝试 实现 博客 的 评论 系统 ， 并 通过 电子 邮件 共享 帖子 内 容 。 此 外 ， 本 章 还 将 讨 
论 标签 系统 的 构建 处 理 过 程 。 


IV. 


第 3 章 将 介绍 如 
网 站 地 图 框架 ， 并 对 
建 搜索 
第 4 章 讨论 如 何 
， 本 章 还 将 了 解 如 
到 项 目 中 去 。 

第 5 章 将 讨论 如 


多 
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展示 了 如 何 生成 图 


擎 ， 我 们 将 完善 博客 应 上 


多 对 多 的 关系 ， 在 JavaScript 


Django 项 目 实例 精 解 〈 第 2 版 ) 


何 创 建 自 定义 模板 标签 和 过 滤器 。 除 此 之 外 ， 本 章 还 将 展示 如 何 使 
帖子 构建 博客 订阅 功能 。 最后， 通过 PostgreSQL 的 全 文本 搜索 功能 构 
程序 。 

构建 社交 网 站 , 并 使 用 Django 身份 验证 框架 构建 用 户 的 账户 视图 。 
何 使 用 社交 网 络 创建 自 定义 用 户 配置 文件 模型 ， 并 将 身份 验证 机 制 应 


局 池 


何 将 社交 应 用 程序 转换 为 图 像 书签 站 点 。 其 中 ， 我 人 
创建 一 个 AJAX 书签 ， 并 将 其 集成 到 项 目 
像 缩 略图 和 为 视图 创建 自 定义 装饰 器 。 


将 针对 模型 定义 
中 。 本 章 还 进 一 


第 6 章 介绍 如 何 


针对 用 户 构建 跟踪 系统 ， 并 通过 创建 用 户 活动 流 应 用 程序 完成 图 像 书 


签 站 点 ,以 及 如 何 优化 QuerySets 并 与 信号 协同 工作 。 同时 , 本 章 还 将 Redis 整合 至 项 目 中 ， 
以 对 图 像 视图 进行 计数 。 


第 7 章 将 讨论 如 


何 构建 一 个 在 线 商 店 , 其 中 包括 目录 模型 、 基 于 Django 会 话 的 购物 车 


〈 并 对 此 设置 上 下 文 处 理 器 ) ， 以 及 通过 Celery 向 用 户 发 送 异步 通知 。 


第 8 章 讨论 如 人 


单 导出 到 CSV 文件 中 ， 


将 支付 网 关 整 合 至 在 线 商 店 中 。 除 此 之 外 ， 还 将 定制 管理 站 点 以 将 订 
并 动态 生成 PDF 发 票 。 


第 9 章 将 讨论 妇 


中 实现 国际 化 机 制 以 及 如 何 转换 模型 。 


第 10 章 将 设计 - 
置 自 定义 模型 字段 、 


章 将 党 : 试 构建 -个 学 9 
同 的 课程 内 容 ， 同 时 还 将 学 习 如 


第 11 间 


何 创建 优惠 券 系统 并 使 用 折扣 订单 。 同 时 ， 本 章 还 展示 了 如 何在 项 目 
此 外 ， 还 将 使 用 Redis 构建 一 个 产品 推荐 引擎 。 

-个 电子 教育 平台 ,并 向 项 目 中 添加 某 些 固件 、 使 用 模型 继承 机 制 、 设 
使 用 类 视图 ， 以 及 管理 分 组 和 权限 。 此 外 ， 我 们 还 将 打造 一 个 内 容 管 


a 


生 注册 系统 ,并 管理 
何 使 用 缓存 框架 。 


理学 生 的 课程 注册 行为 。 该 系统 将 显示 不 


第 12 章 将 采用 Django REST 框架 ， 进 而 针对 项 目 构建 RESTful API。 


第 13 章 讨论 如 人 
此 外 ， 本 章 还 解释 了 


背景 知识 


阅读 本 


忆 时 ， 


可 通过 uWSGI 和 NGINX 设置 产 


品 环境 ， 并 利 
如 何 构建 自 定义 中 间 件 以 及 自 定义 管理 命令 。 


用 SSL 解决 安全 问题 。 


建议 读者 具备 一 定 的 Python 知识 ， 并 熟悉 HTML 以 及 JavaScript。 另 


外 , 在 


阅读 本 书 之 前 ， 


建议 读者 阅读 Django 官方 文档 的 1 一 3 部 分 , 对 应 网 址 为 https://docs. 


mt 
者 


前 


djangoproject.com/en/2.0/intro/tutorial01/。 


资源 下 载 


读者 可 访问 http://www.packtpub.com 并 通过 个 人 账户 下 载 示例 代码 文件 。 在 http://www. 
packtpub.com/support 网 站 注册 成 功 后 ， 我 们 将 以 电子 邮件 的 方式 将 相关 文件 发 与 读者 。 
读者 可 根据 下 列 步 又 下 载 代码 文件 : 
(1) 登录 www.packtpub.com 并 在 网 站 注册 。 
(2) 选择 Support 选项 卡 。 
(3) 单 击 CODE DOWNLOADS & ERRATA。 
(4) 在 Search 文本 框 中 输入 书 名 并 执行 后 续 命令 。 
当 文件 下 载 完毕 后 ， 确 保 使 用 下 列 最 新 版 本 软件 解压 文件 夹 ; 
口 Windows 系统 下 的 WinRAR/7-Zip。 
口 Mac 系统 下 的 Zipeg/iZip/UnRarX。 
口 Linux 系统 下 的 7-Zip/PeaZip。 
另外 ， 读 者 还 可 访问 GitHub 获取 本 书 的 代码 包 ， 对 应 网 址 为 https://github.com/ 
PacktPublishing/Django-2-by-Example。 
此 外 ， 读 者 还 可 访问 https://github.com/PacktPublishing/ 网 站 ， 以 了 解 丰富 的 代码 和 视 
频 资源 。 


本 书 约定 


代码 块 则 通过 下 列 方式 设置 : 


from django.contrib import admin 
from .models import Post 


admin.site.register (Post) 
代码 中 的 重点 内 容 则 采用 黑体 表示 : 


INSTALLED APPS = [ 
'django.contrib.admin', 
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"django .contrib.auth'" 
"django .contrib .contenttypes' 
"django .contrib.-sessions'v 
"django .contrib.messages'v 
"django .contrib.staticfiles'， 
'blog.apps.BlogConfig', 

] 


命令 行 输 入 或 输出 如 下 所 示 : 

$ Python manage.py startapp blog 
国标 表示 较为 重要 的 说 明 事项 。 
例 图 标 则 表示 提示 信息 和 操作 技巧 。 


读者 反馈 和 客户 支持 


欢迎 读者 对 本 书 提出 建议 或 意见 并 予以 反馈 。 
对 此 ， 读 者 可 向 feedback@packtpub.com 发 送 邮 件 ， 并 以 书 名 作为 邮件 标题 。 若 读者 
对 本 书 有 任何 疑问 ， 均 可 发 送 邮件 至 questions@packtpub.com， 我 们 将 竭诚 为 您 服务 。 


勘误 表 


尽管 我 们 希望 做 到 尽善尽美 ， 但 错误 依然 在 所 难免 。 如 果 读 者 发 现 廖 误 之 处 ， 无 论 是 
文字 错误 抑或 是 代码 错误 ， 还 望 不 音 赐 教 。 对 此 ， 读 者 可 访问 http:/www.packtpub.comy/ 
submit-errata， 选 取 对 应 书籍 ， 输 入 并 提交 相关 问题 的 详细 内 容 。 


版 权 须 知 


一 直 以 来 ， 互联 网 上 的 版 权 问题 从 未 间断 ，Packt 出 版 社 对 此 类 问题 异常 重视 。 若 读者 
在 互联 网 上 发 现 本 书 任意 形式 的 副本 ， 请 告知 我 们 网 络 地 址 或 网 站 名 称 ， 我 们 将 对 此 予以 
处 理 。 关 于 盗版 问题 ， 读 者 可 发 送 邮件 至 copyright@packtpub.com。 


前 言 


若 读者 针对 某 项 技术 具有 专家 级 的 见解 ， 抑 或 计划 撰写 书籍 或 完善 某 部 著作 的 出 版 工 


作 ， 则 可 访问 www.packtpub.com/authors。 
问题 解答 


1 读者 对 本 书 有 任何 疑问 ， 均 可 发 送 邮 件 至 questions@packtpub.com， 我 们 将 竭诚 为 
您 服务 。 
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本 书 将 学 习 如 何 构建 完整 的 Django 项 目 ， 以 备 产品 使 用 。 本 章 首先 介绍 Django 的 
安装 操作 ， 随 后 通过 Django 创建 简单 的 博客 应 用 程序 。 本 章 旨 在 向 读者 介绍 Django 框 
架 的 工作 方式 ， 理 解 不 同 组 件 间 的 交互 方式 ， 并 构建 包含 基本 功能 的 Django 项 目 。 在 打 
造 完整 项 目的 过 程 中 ， 读 者 不 必 了 解 某 些 细节 内 容 ， 本 书后 续 章节 将 对 不 同 的 框架 组 件 
予以 详细 讨论 。 

本 章 主要 包含 以 下 内 容 : 

口 ”安装 Django 并 创建 第 一 个 项 目 。 
设计 模型 并 实现 模型 移植 。 
针对 模型 构建 管理 站 点 。 

与 QuerySet 和 管理 器 协同 工作 。 
构建 视图 、 模 板 以 及 URL。 

向 列表 视图 添加 分 页 机 制 。 
使 用 Django 的 类 视图 。 


OOOODODD 


1.1 安装 Django 


如 果 读 者 已 经 安装 了 Django， 则 可 忽略 本 节 内 容 。Django 位 于 Python 包 中 ， 因 而 可 
在 Python 环境 下 进行 安装 。 如果 尚未 安装 Django， 下列 内 容 提供 了 本 地 环境 下 的 Django 
安装 的 快速 指导 。 

Django 2.0 需要 使 用 到 Python 3.4 或 更 高 的 版 本 。 在 本 书 示 例 中 ， 将 使 用 到 Python 3.6.5。 
对 于 Linux 或 maxOS X，Python 可 能 已 安装 于 其 中 ， 对 于 Windows 环境 ， 首 先 需要 访问 
https://www.python.org/downloads/windows/， 并 下 载 Python 安装 程序 。 

如 果 读 者 并 不 确定 是 否 安装 了 Python， 则 可 在 shell 中 输入 python 进行 验证 。 若 输 旨 
下 列 内 容 ， 则 表明 Python 已 在 计算 机 设备 中 安装 完毕 。 

Python 3.6.5 (v3.6.5:f59c0932b4，Mar 28 2018, 03:03:55) 

[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin 


Type "help", "copyright", "credits" or "license" for more information. 
>>> 


2 
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如 果 Python 版 本 低 于 3.4， 抑 或 Python 尚未 在 计算 机 上 安装 ， 可 访问 https://www. 
python.org/downloads 下 载 并 安装 。 

鉴于 安装 了 Python 3， 因 而 不 必 再 安装 数据 库 ， 该 版 本 中 内 建 了 SQLite。SQLite 是 
一 种 轻 量 级 的 数据 库 ， 并 可 在 开发 过 程 中 与 Django 协同 使 用 。 如 果 和 希望 在 产品 环境 中 部 
署 应 用 程序 ， 则 需要 使 用 更 加 高 级 的 数据 库 ， 如 PostgreSQL、MySQL 或 Oracle。 关 于 数 
据 库 与 Django 间 的 关系 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/install/ 
#database-installation 以 获取 更 多 内 容 。 


1.1.1 创建 隔离 的 Python 环境 


这 里 ， 建 议 使 用 virtualenv 创建 隔离 的 Python 环境 ， 进 而 可 针对 不 同 的 项 目 使 用 不 
同 的 数据 包 版 本 ， 这 比 在 系统 范围 内 安装 Python 包 要 实用 得 多 。 采 用 virtualenv 的 另 一 
个 优点 是 ， 安 装 Python 包 不 需要 任何 管理 特权 。 我 们 可 在 shell 中 运行 下 列 命令 安装 
Virtualenv: 

pip install virtualenV 

待 virtualenv 安装 完毕 后 ， 可 利用 下 列 命 令 生成 隔离 环境 : 

Virtualenv my_env 

相应 地 ， 这 将 创建 my_env/ 目 录 ， 同 时 包括 Python 环境 ， 当 虚拟 环境 处 于 活动 状态 
时 ， 任 何 所 安装 的 Python 库 均 位 于 my_env/lib/python3.6/site-packages 目录 中 。 
Di 

如 果 系 统 中 存在 Python 2.X， 并 于 随后 安装 了 Python 3 又 ， 则 需要 通知 virtualenv 使 
用 后 者 。 


我 们 可 设置 Python 3 的 安装 路 径 ， 并 通过 下 列 命令 创建 虚拟 环境 ; 

zenx$ which Python3 
/Library/Frameworks/Python.framework/Versions/3.6/bin/python3 
Zenx$ virtualenv my env -p 
/Library/Frameworks/Python.framework/Versions/3.6/bin/python3 


运行 下 列 命令 将 激活 虚拟 环境 : 
source my_env/bin/activate 


shell 提示 符 将 在 括号 中 包含 处 于 活动 状态 下 的 、 虚 拟 环境 的 名 称 ， 如 下 所 示 : 


(my_env) laptop:~ ZenXS$ 
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相反 ， 利 用 deactivate 命令 ， 可 随时 禁用 当前 环境 。 

关于 virtualenv 的 更 多 信息 ， 读 者 可 访问 https://virtualenv.pypa.io/en/latest/。 

在 virtualenv 之 上 ， 用 户 还 可 使 用 virtualenvwrapper。 这 个 工具 提供 了 封装 器 ， 从 而 
可 简化 虚拟 环境 的 创建 和 管理 。 对 此 ， 可 访问 https://virtualenvwrapper.readthedocs.io/en/ 
latest/ 下 载 virtualenvwrapper。 


1.1.2 ”利用 pip 安装 Django 


对 于 Django 的 安装 ， 建 议 采 用 pip 包 管 理 系统 这 一 方法 。Python 3.6 中 预先 安装 了 
pip， 另 外 ， 读 者 也 可 访问 https://pip.pypa.io/en/stable/installing/ 以 了 解 pip 的 安装 指令 。 

在 shell 提示 符 下 运行 以 下 命令 ， 并 利用 pip 安装 Django。 

Pip install Django==2.0.5 

相应 地 ，Django 将 被 安装 于 虚拟 环境 下 的 site-packages/ 目 录 下 。 

接 下 来 ， 可 检测 Django 是 否 已 经 安装 成 功 。 针 对 于 此 ， 可 在 终端 上 运行 python， 导 
入 Django 并 检查 其 版 本 ， 如 下 所 示 : 


>>> import django 
>>> django.get version() 
Wo 


上 述 输出 结果 表明 Django 已 被 成 功 地 安装 在 机 器 设备 上 。 
OO 总: 

Django 可 通过 多 种 方式 进行 安装 ,读者 可 访问 https://docs.djangoproject.com/en/2.0/ 
topics/install/， 以 了 解 完整 的 安装 过 程 。 


1.2 创建 第 一 个 项 目 


我 们 的 第 一 个 项 目 是 创建 一 个 完整 的 博客 。Django 提供 了 一 个 命令 ， 并 可 创建 初始 
项 目 文件 结构 。 对 此 ， 可 在 shell 中 运行 下 列 命令 : 

django-admin startproject mysite 

这 将 创建 名 为 mysite 的 Django 项 目 。 
食 提 未 : 

不 应 使 用 内 置 Python 或 Django 模块 命名 项 目 ， 以 避免 冲突 。 
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考察 下 列 生成 的 项 目 结构 : 


mysite/ 
manage .py 
mysite/ 
证 BY 
settings.py 
urls.py 
wsgi.py 
上 述 文件 具体 解释 如 下 : 
口 manage.py 表示 为 命令 行 工具 ， 并 与 当前 项 目 进行 交互 ;同时 也 是 一 个 
django-admin py 工具 的 封装 器 。 用 户 无 须 编辑 该 文件 。 
口 mysite/ 表 示 为 项 目 目录 ， 其 中 包含 了 下 列 文件 : 
> _init .py 表示 为 一 个 空 文件 ,并 通知 Python 将 mysite 目录 视 为 一 个 Python 


模块 。 
> settings.py 表示 当前 项 目的 设置 和 配置 项 , 并 包含 了 初始 状态 下 的 默认 设置 
内 容 。 


> urlspy 中 包含 了 URL 路 径 。 其 中 ， 每 个 定义 的 URL 将 映射 至 一 个 视图 上 。 
> wsgipy 配置 作为 Web 服务 器 网 关 接 口 (WSGI) 应 用 程序 运行 项 目 。 
生成 的 settings.py 文件 涵盖 了 当前 项 目 设 置 ， 其 中 包含 了 基本 的 配置 ， 并 使 用 了 
SQLite 3 数据 库 以 及 INSTALLED_APPS 列表 , 这 其 中 包含 了 默认 状态 下 添加 至 当前 项 目 
中 的 公共 Django 应 用 程序 。 稍 后 将 对 此 类 应 用 程序 加 以 讨论 。 
为 了 完成 项 目 设置 ， 我 们 需要 在 数据 库 中 创建 INSTALLED_APPS 中 列 出 的 应 用 程 
序 所 需 的 表 。 对 此 ， 打 开 shell 并 运行 下 列 命 令 : 
cd mysite 
python manage.py migrate 
我 们 将 会 看 到 以 下 列 代码 行 结尾 的 输出 内 容 : 
Applying contenttypes.0001 initial... OK 
Applying auth.0001 initial... OK 
Applying admin.0001 initial... OK 
Applying admin.0002 logentry remove auto add... OK 
Applying contenttypes.0002 remove content type name... OK 
Applying auth.0002 alter permission name max length... OK 
Applying auth.0003 alter user email max length... OK 
Applying auth.0004 alter user username opts... OK 
Applying auth.0005 alter user last login null... OK 
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Applying auth.0006 require contenttypes 0002... OK 

Applying auth.0007 alter validators add error messages... OK 

Applying auth.0008 alter user username max length... OK 

Applying auth.0009 alter user last name max length... OK 

Applying sessions.0001 initial... OK 

上 述 代码 行 表 示 为 Django 所 用 的 数据 库 迁 移 。 通 过 迁移 ， 初 始 状态 下 的 应 用 程序 表 
将 在 数据 库 中 被 创建 。 本 章 稍 后 将 对 迁移 管理 命令 加 以 讨论 。 


1.2.1 运行 开发 服务 器 


Django 中 包含 了 轻 量 级 的 Web 服务 器 ， 并 可 快速 运行 代码 ， 且 无 须 花 费 额外 的 时 间 
配置 产品 服务 器 。 当 运行 Django 开发 服务 器 时 ， 会 不 断 检查 代码 中 的 更 改 内 容 ， 同 时 会 
自动 重新 加 载 ， 从 而 不 必 在 代码 更 改 后 手动 重新 进行 加 载 。 需 的 是 ， 某 些 操作 可 
能 会 被 忽略 ， 例 如 向 项 目 中 添加 新 文件 ， 因 此 在 这 些 情况 下 必须 手动 重新 启动 服务 器 。 

在 项 目的 根 文件 夹 下 输入 下 列 命 令 ， 即 可 启动 开发 服务 器 : 

python manage.py runserver 

对 应 输出 结果 如 下 所 示 : 


Performing system checks... 


System check identified no issues (0 silenced). 

May 06, 2018 - 17:17:31 

Django version 2.0.5, using settings 'mysite.settings' 

Starting development server at http://127.0.0.1:8000/ 

Quit the server with CONTROL-C. 

当前 ， 可 在 浏览 器 中 运行 http://127.0.0.1:8000/， 随 后 将 显示 项 目 运 行 成 功 页 面 ， 如 
图 1.1 所 示 。 

图 1.1 表明 Django 正 于 运行 状态 ， 当 查看 控制 台 时 ,将 会 看 到 浏览 器 执行 的 GET 请 
求 ， 如 下 所 示 : 


[06/May/2018 17:20:30] "GET / HTTP/1.1" 200 16348 


相应 地 ， 每 个 HTTP 请 求 均 在 开发 服务 器 控制 台中 被 记录 。 当 运行 开发 服务 器 时 ， 
所 出 现 的 每 个 错误 也 会 显示 于 控制 台中 。 

我 们 还 可 以 指示 Django 在 自 定义 的 主机 和 端口 上 运行 开发 服务 器 ; 或 者 通知 Django 
运行 项 目 ， 同 时 加 载 不 同 的 设置 文件 ， 如 下 所 示 ; 
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Python manage.py runserver 127.0.0.1:8001 \ 
--settings=mysite.settings 


. < 127.0.0.1:8000 


django View release notes for Django 2.0 


The install worked successfully! Congratulations! 


You are seeing this page because DEBUG=True is in 
your settings file and you have not configured any 
URLs. 


© Diango Documentation «> Tutorial: A Polling App gg, Django Community 


图 1.1 

他 提示 : 

当 处 理 包 含 不 同 配置 的 多 种 环境 时 ， 可 针对 每 种 环境 创建 不 同 的 设置 文件 

需要 注意 的 是 ， 该 服务 器 仅 适 用 于 开发 环境 ， 而 非 产品 应 用 场合 。 当 在 产品 环境 下 
部 署 Django 时 ， 需 要 使 用 真实 的 Web 服务 器 并 作为 WSGI 应 用 程序 予以 运行 ， 例 如 
Apache、Gunicor 或 uWSGI。 关 于 如 何在 不 同 的 Web 服务 器 上 部 署 Django， 读 者 可 访 
问 https://docs.djangoproject.com/en/2.0/howto/deployment/wsgi/ 获 取 更 多 信息 。 

男 外， 第 13 章 还 将 介绍 如 何 针对 Django 项 目 设置 产品 环境 。 


1.2.2 项目 设置 


下 面 打开 settings.py 文件 ， 并 查看 当前 项 目的 配置 内 容 。 该 文件 中 涵盖 了 Django 所 
包含 的 多 项 设置 ， 但 仅 是 Django 设置 的 一 部 分 内 容 。 读 者 可 访问 https://docs.djangoproject. 
com/en/2.0/ref/settings/ 查 看 全 部 设置 项 和 默认 值 。 
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我 们 需要 格外 重视 下 列 设置 项 : 


口 


口 口 


口 


口 
口 


DEBUG 定义 为 一 个 布尔 值 ， 表 示 开 启 /禁用 当前 项 目的 调试 模式 。 如 果 DEBUG 
设置 为 True, 当 应 用 程序 抛 出 未 捕获 的 异常 时 ,Django 将 显示 详细 的 错误 页 面 。 
对 于 产品 环境 ， 需 要 将 其 设置 为 False。 由 于 将 会 暴露 某 些 与 项 目 相关 的 敏感 数 
据 ， 因 而 不 可 在 DEBUG 处 于 开启 状态 下 将 某 个 站 点 部 署 至 产品 中 。 
当 开 启 调试 模式 或 者 执行 测试 时 ，ALLOWED HOSTS 不 可 用 。 一 旦 将 站 点 转 
移 到 产品 环境 并 将 DEBUG 设置 为 False， 则 需要 将 域 /主机 添加 到 此 设置 中 ， 以 
允许 它 为 Django 站 点 服务 。 
INSTALLED_APPS 表示 为 需要 针对 全 部 项 目 进行 编辑 的 设置 项 , 该 设置 项 通知 
Dijango 针对 当前 站 点 的 哪 一 个 应 用 程序 处 于 活动 状态 。 默 认 状 态 下 ，Django 包 
了 以 下 应 用 程序 。 

django.contrib.admin: 管理 站 点 。 

django.contrib.auth: 验证 框架 。 

django.contrib.contenttypes: 处 理 内 容 类 型 的 框架 。 

django.contrib.sessions: 会 话 框架 。 

django.contrib messages: 消息 机 制 框架 。 

django.contrib.staticfiles: 管理 静态 文件 的 框架 。 
MIDDLEWARE 表示 为 中 间 件 列表 。 
ROOT _ URLCONEF 表示 Python 模块 ， 其 中 定义 了 应 用 程序 的 根 URL 路 径 。 
DATABASES 表示 为 一 个 字典 , 其 中 涵盖 了 应 用 程序 所 使 用 的 全 部 数据 库 设置 。 
注意 ， 此 处 须 设置 默认 数据 库 。 针 对 于 此 ， 默 认 配 置 中 采用 了 SQLite3 数据 库 。 
LANGUAGE _ CODE 针对 当前 Django 站 点 定义 了 默认 的 代码 语言 。 
USE_TZ 通知 Django 启用 /禁用 时 区 支持 。Django 提供 了 基于 时 区 的 日 期 显示 。 
当 采 用 startproject 管理 命令 创建 一 个 新 项 目 时 ， 该 设置 项 将 被 定义 为 True。 


VvVvVvvv 公 


如 果 读 者 尚 不 理解 上 述 内 容 ， 也 不 必 感 到 惊慌 ， 后 续 章 节 还 将 对 不 同 的 Django 设置 
加 以 讨论 。 


123 


本 书 中 ， 将 会 反复 出 现 项 目 和 应 用 程序 这 一 类 术语 。 在 Django 中 ， 项 目 被 视 为 基于 


项 目 和 应 用 程序 


某 些 设置 项 的 Django 安装 结果 ， 应 用 程序 则 表示 为 模型 、 视 图 、 模 板 以 及 URL 的 组 合 。 


应 月 


日程 


序 与 框架 进行 交互 ， 提 供 特定 的 功能 ， 并 可 在 不 同 的 项 目 中 加 以 复 用 。 我 们 可 以 


将 项 目 视 为 一 个 站 点 ， 其 中 包含 了 多 个 应 用 程序 ， 例 如 博客 、wiki 或 论坛 ， 同 时 还 可 被 


。8 。 


2 


本 节 将 创 到 
中 ， 可 运行 下 列 命令 : 


其 他 项 目 予 以 复 用 。 


创建 应 用 程序 
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Python manage.py startapp blog 
这 将 生成 该 应 用 程序 的 基本 结构 ， 如 下 所 示 : 


blog/ 


init sp 


admin.py 
apps.py 
migrations/ 


init .py 


models.py 
tests.py 
Views .py 


上 述 文件 具体 解释 如 下 : 
admin.py 文件 。 可 在 该 文件 中 注册 模型 ， 并 将 其 纳入 至 Django 管理 站 点 中 一 一 
使 用 Django 管理 站 点 为 可 选项 。 
apps.py 文件 。 该 文件 中 包含 了 博客 应 用 程序 中 的 主要 配置 内 容 。 


口 


口 
口 


口 


migrations 目录 。 该 目录 中 包含 了 应 月 


踪 模 块 变 化 内 容 ， 并 相应 地 同步 数据 


第 一 个 Django 项 目 并 从 头 开始 构建 一 个 博客 应 用 程序 。 在 项 目的 根 目录 


程序 的 数据 库 迁 移 。 迁 移 可 使 Django 跟 


库 。 


models.py 文件 。 所 有 的 Django 应 用 程序 都 需要 设置 该 文件 , 其 中 包含 了 应 用 程 


Views.py 文件 。 该 文件 中 包含 了 应 用 


请 求 ， 经 处 理 后 返 


序 的 数据 模型 ， 但 该 文件 也 可 被 置 空 。 
tests.py 文件 。 可 在 该 文件 中 添加 应 用 


程序 测试 。 


L.3 


回 一 个 响应 结果 。 


程序 逻辑 内 容 ， 每 个 视图 接收 一 个 HTTP 


设计 博客 数据 方案 


本 节 开 始 着 手 设计 博客 数据 方案 ， 即 针对 博客 定义 数据 模型 。 这 里 ， 模 型 表示 为 一 
个 Python 类 ,并 定义 为 django.db.models.Model 的 子 类 。 其 中 , 每 个 属性 视 为 一 个 数据 库 
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字段 。Django 针对 定义 于 models.py 文件 中 的 每 个 模型 创建 一 个 表 。 当 创建 一 个 模型 时 ， 
Dijango 提供 了 一 个 实用 的 API， 从 而 可 方便 地 查询 数据 库 中 的 对 象 。 
首先 定义 一 个 Post 模型 ， 并 向 博客 应 用 程序 的 models.py 文件 中 添加 下 列 代码 行 : 
from django.db import models 


from django.utils import timezone 
from django.contrib.auth.models import User 


Class Post (models.Model) : 


STATUS CHOICES = ( 
Curaet "Drare ys 
('published', 'Published'), 
) 
title = models.CharField (max length=250) 
slug = models.SlugField (max length=250, 
unique for date='publish') 
author = models.ForeignKey (User, 
on delete=models .CASCADE, 
related name='blog posts') 
body = models.TextField() 
publish = models.DateTimeField (default=timezone.now) 
created = models.DateTimeField (auto now add=True) 
updated = models.DateTimeField (auto now=True) 
status = models.CharField (max length=10, 
choices=STATUS CHOICES, 
default='draft') 


class Meta: 
ordering = ('-publish',) 


def str (self): 
return self.title 


这 表示 为 博客 帖子 的 数据 模型 。 下 面 查 看 针对 该 模型 定义 的 相关 字段 ， 如 下 所 示 : 


口 


口 


口 


title 表示 为 帖子 标题 字段 。 该 字段 定义 为 CharField， 在 SQL 数据 库 中 将 转换 为 
VARCHAR 列 。 

slug 字段 用 于 URL 中 。 作 为 一 种 简短 的 标记 ，slug 仅 包含 字 母 、 数 值 、 下 画 线 
以 及 连 字 符 。 根 据 slug 字段 ， 可 针对 博客 帖子 构建 具有 较 好 外 观 的 、SEO 友好 
的 URL。 之 前 曾 向 该 字段 中 添加 了 unique for date 参数 ， 进 而 可 采用 发 布 日 期 
和 slug 对 帖子 构建 URL。Django 不 支持 多 个 帖子 在 既定 日 期 拥有 相同 的 slug。 
author 字段 表示 为 一 个 外 键 ， 并 定义 了 多 对 一 的 关系 。 有 具体 来 说 ， 我 们 将 通知 
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Django， 每 个 帖子 由 某 位 用 户 编写 ， 但 一 个 用 户 可 编写 多 个 帖子 。 对 于 该 字段 ， 
Django 通过 相关 模型 的 主键 在 数据 库 中 生成 了 一 个 外 键 。 此 时 ， 我 们 将 借助 于 
Dijango 验证 系统 中 的 User 模型 。 当 删除 引用 对 象 时 ，on_delete 参数 指定 了 所 使 
的 操作 行为 一 一 这 并 非 是 Django 规范 , 而 是 一 类 SQL 标准 。 当 采用 CASCADE 
并 删除 引用 用 户 时 ， 数 据 库 还 将 删除 其 所 关联 的 博客 帖子 。 读 者 可 访问 
https://docs.djangoproject.com/en/2.0/ref/models/fields/#django.db.models.ForeignKey. 
on_delete 以 查看 全 部 选项 ,我 们 使 用 related_name 属性 指定 反 向 关系 的 名 称 (从 
Uset 到 Post) ， 这 可 以 方便 地 访问 相关 对 象 。 稍 后 将 对 此 加 以 详细 讨论 。 
口 ”body 表示 为 帖子 的 主体 ， 且 设置 为 文本 字段 ， 同 时 转换 为 SQL 数据 库 中 的 
TEXT 列 。 
口 “publish 表示 为 帖子 的 发 布 日 期 。 此 处 使 用 了 Django 的 时 区 now 方法 作为 默认 
值 , 并 以 时 区 格式 返回 当前 日 期 。 我 们 可 将 其 视 为 Python 标准 方法 datetime.now 
的 时 区 版 本 。 
口 created 表示 帖子 的 创建 时 间 。 鉴 于 此 处 采用 了 auto_now_add， 当 创建 某 个 对 象 
时 ， 日 期 将 被 自动 保存 。 
口 updated 表示 帖子 最 后 一 次 更 新 的 时 间 。 鉴 于 此 处 采用 了 auto_now， 因 而 当 保存 
某 个 对 象 时 ， 日 期 将 被 自动 保存 。 
口 status 显示 了 帖子 的 状态 。 由 于 使 用 了 choices 参数 ， 因 而 该 字段 值 仅 设置 为 既 
定 选择 方案 中 的 某 一 个 方案 。 
Django 中 包含 了 不 同 的 字段 类 型 , 并 以 此 定义 模型 。 读者 可 访问 https://docs.djangoproject. 
com/en/2.0/ref/models/fields/ 以 查看 所 有 的 字段 类 型 。 
模型 内 的 Meta 类 包含 了 元 数据 。 默 认 状态 下 ， 当 查询 元 数据 时 ， 将 通知 Django 对 
publish 字段 中 的 结果 以 降序 排序 。 通 过 负 号 前 缀 ， 可 指定 降序 排列 。 据 此 ， 最 新 发 布 的 
帖子 将 首先 加 以 显示 。 
_ str_ (方法 为 默认 的 人 们 可 读 的 对 象 表达 方式 ，Django 将 在 多 处 对 其 加 以 使 用 
如 管理 站 点 。 


Os: 
如 果 读 者 使 用 的 是 Python 2.X， 注 意 ， 在 Python 3 中 ， 全 部 字符 串 在 本 地 均 视 为 
Unicode， 因 而 我 们 仅 使 用 _str (), 而 _unicode (0) 则 已 过 时 。 


1.3.1 激活 应 用 程序 


为 了 使 Django 跟踪 应 用 程序 ， 同 时 可 针对 其 模型 创建 数据 表 ， 我 们 需要 对 其 予以 激活 。 
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对 此 ， 可 编辑 settings.py 文件 ， 并 向 INSTALLED_APPS 设置 中 加 入 blog.apps.BlogConfig， 
如 下 所 示 : 
INSTALLED APPS = [ 
"django .contrib.admin'， 
"django .contrib .auth'， 
"django .contrib .contenttypes'， 
"django .contrib.sessions'， 
"django .contrib.messages'， 
"django .contrib.staticfiles'， 
'blog.apps.BlogConfig', 
] 
BlogConfig 类 定义 了 应 用 程序 的 配置 内 容 。 当 前 ，Django 了 解 到 应 用 程序 针对 项 目 
处 于 活动 状态 ， 并 可 加 载 其 模型 。 


1.3.2 ”设置 并 使 用 迁移 方案 


前 述 内 容 针 对 博客 帖子 创建 了 数据 模型 ， 我 们 需要 对 此 定义 数据 库 表 。Django 配置 
了 迁移 系统 ， 跟 踪 模 型 产生 的 变化 内 容 ， 并 将 其 传送 至 数据 库 中 。 相 应 地 ，migrate 命令 
可 针对 INSTALLED_APPS 列 出 的 全 部 应 用 程序 执行 迁移 操作 并 同步 对 应 的 数据 库 (其 
We 当前 模型 和 现 有 的 迁移 内 容 ) 。 
首先 需要 针对 Post 模型 创建 初始 迁移 。 在 项 目的 根 目录 中 ， 可 运行 下 列 命令 : 


python manage.py makemigrations blog 


对 应 输出 结果 如 下 所 示 : 
Migrations for 'blog': 

blog/migrations/0001 initial.py 

- Create model Post 

Django 在 blog 应 用 程序 的 migrations 目录 内 仅 生 成 了 0001_initial.py 文件 ,我 们 可 以 
该 文件 查看 迁移 结果 。 迁 移 指 定 了 在 数据 库 中 执行 的 其 他 迁移 和 操作 的 依赖 关系 ， 
以 便 与 模型 变化 同步 。 

下 面 考 察 Django 在 数据 库 中 执行 的 SQL 代码 ， 以 创建 模型 表 。sqlmigrate 命令 将 使 
到 迁移 名 称 并 在 不 执行 SQL 的 情况 下 返回 其 SQL。 运行 以 下 命令 并 检查 第 一 次 迁移 的 
SQL 输出 结果 : 


python manage.py sqlmigrate blog 0001 
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对 应 输出 结果 如 下 所 示 : 


BEGIN; 


-- Create model Post 


CREATE TABLE "blog post" ("id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, 

"title" varchar (250) NOT NULL, "slug" varchar(250) NOT NULL, "body" text 

NOT NULL, "publish" datetime NOT NULL, "created" datetime NOT NULL, 

"updated" datetime NOT NULL, "status" varchar(10) NOT NULL, "author id" 

integer NOT NULL REFERENCES "auth user" ("id")); 

CREATE INDEX "blog post slug b95473f2" ON "blog post" ("slug"); 

CREATE INDEX "blog post author id dd7a8485" ON "blog post" ("author id"); 

COMMIT; 

实际 输出 结果 取决 所 用 的 数据 库 , 上 述 输出 结果 为 SQLite 所 生成。 不 难 发 现 , Django 
通过 组 合 应 用 程序 名 称 以 及 模型 (blog_post〉 的 小 写 名 称 生 成 表 名 。 男 外 ， 还 可 以 使 用 
db_table 属性 在 模型 的 Meta 类 中 为 模型 指定 一 个 定制 的 数据 库 名 称 。Django 对 每 个 模型 
自动 生成 主键 ， 但 也 可 在 模型 字段 中 指定 primary key=True 以 对 此 进行 覆 写 。 此 处 ， 默 
认 的 主键 表示 为 id 列 ， 并 由 一 个 整数 构成 ， 同 时 实现 自动 递增 。 该 列 对 应 于 自动 添加 至 
模型 中 的 id 字段 。 

接 下 来 将 数据 库 与 新 模型 同步 。 运 行 以 下 命令 来 应 用 现 有 迁移 : 

Python manage.py migrate 

对 应 输出 结果 如 下 所 示 : 

Applying blog.0001 initial... OK 


我 们 只 是 为 INSTALLED_APPS 中 列 出 的 应 用 程序 使 用 了 迁移 ， 包 括 我 们 的 blog 应 
用 程序 。 在 应 用 迁移 之 后 ， 数 据 库 反映 了 模型 的 当前 状态 。 
当 编 辑 models.py 文件 ， 以 添加 、 移 除 或 修改 现 有 模型 的 字段 时 ， 或 者 添加 新 的 方法 
时 ， 则 需要 利用 makemigrations 命令 创建 新 的 迁移 。 该 迁移 使 得 Django 可 跟踪 模型 的 变 
化 状态 。 随 后 ， 还 需 将 其 与 migrate 命令 一 起 应 用 ， 以 使 数据 库 与 模型 保持 同步 。 


1.4 针对 模型 创建 管理 站 点 


之 前 曾 定义 了 Post 模型 ， 本 节 将 创建 简单 的 管理 站 点 并 对 博客 帖子 进行 适当 管理 。 
Django 包含 了 内 建 的 管理 接口 ， 这 对 于 编辑 内 容 来 说 十 分 有 用 。 通 过 读 取 模 型 元 数据 ， 


要 


第 1 章 构建 博客 应 用 程序 


。13。 


提供 针对 编辑 内 容 的 产品 接口 ，Django 可 自动 构建 管理 站 点 。 用 户 可 直接 对 其 加 以 


， 并 配置 模型 的 显示 方式 。 


django.contrib.admin 已 包含 于 INSTALLED_APPS 设置 中 ， 因 而 无 须 对 


1.4.1 创建 超级 用 户 


首先 需要 创建 一 个 用 户 并 管理 站 点 。 对 此 ， 可 运行 下 列 命 
Python manage.py createsuperuser 
对 应 输出 结果 如 下 所 示 ， 其 中 需要 输入 用 户 名 、 电 子 邮 件 以 及 密码 。 


Username (leave blank to use 'admin'): admin 
Email address: admin@admin .com 

asWOrG: 兴 福 胡 训 安安 宙 克 

Password (again) : ** 太 太太 太 太太 

Superuser created successfully. 


1.4.2” Django 管理 站 点 


其 予以 添加 。 


利用 python managepy runserver 命令 启动 开发 服务 器 ， 并 在 浏览 器 中 运行 http://127.0.0.1: 


8000/admin/。 管 理 登 录 页 面 如 图 1.2 所 示 。 


127.0.0.1:8000/admin/login/?next=/admin/ 


Django administration 


Username': 


Password: 


图 1.2 


在 使 用 之 前 创建 的 用 户 凭证 登录 后 ， 将 看 到 管理 站 点 索引 页 面 ， 如 图 


1.3 所 示 。 


图 1.3 中 显示 的 Groups 和 Users 模型 表示 为 django.contrib.auth 中 验证 框架 中 的 部 分 
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内 容 。 当 单 击 Users 时 ， 将 会 看 到 之 前 创建 的 用 户 。blog 应 用 程序 的 Post 模型 包含 了 与 
Users 模型 之 间 的 关系 。 需 要 注意 的 是 ， 这 一 关系 通过 author 字段 加 以 定义 。 


Dja Ngo administration WELCOME ADMIN. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Site administration 


; 
Recent actions 


Groups +Add Change 


Users + Add Change My actions 


None available 


图 1.3 
1.4.3 ”向 管理 站 点 中 添加 模型 


下 面向 管理 站 点 中 添加 博客 模型 。 对 此 ， 可 编辑 blog 应 用 程序 的 admin.py 文件 ， 如 
下 所 示 : 


from django.contrib import admin 
from .models import Post 


admin.site.register (Post) 


当前 ， 重 新 在 浏览 器 中 加 载 管理 站 点 ， 图 1.4 显示 了 管理 站 点 中 的 Post 模型 。 


[Bjtelatelo:teln lla iedlel WELCOME, ADMIN. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Site administration 


AUTHENTICATION AND AUTHORIZATION 和 
Recent actions 
Groups 十 Add Change 


Users 十 Add Change My actions 


None available 


十 Add ”Change 
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当 在 Django 管理 站 点 中 注册 模型 时 ， 将 会 得 到 通过 内 省 〈introspecting) 模型 生成 的 
户 友好 的 界面 ， 进 而 可 通过 简单 的 方式 列表 、 编 辑 、 创 建 、 删 除 对 象 。 

单 击 Posts 一 侧 的 Add 链接 即 可 加 入 新 的 帖子 。 此 处 ， 我 们 将 会 看 到 Django 针对 模 
型 自动 创建 的 生成 表单 ， 如 图 1.5 所 示 。 


Dja Nn le) ad mmIn Istrat [el WELCOME. ADMIN. VIEW SITE / CHANGE PASSWDRD / LOG OUT 
Home ; Blog，Posts ; Add post 
Add post 

Title: 

Slug: 

Author 


Body: 


Publish: Date: 2017-12-14 Today 的 


Time: 08:54:24 NowIO 


Save and add another Save and continue editing 


图 1 


Django 针对 每 种 字段 类 型 使 用 不 同 的 表单 微 件 。 甚 至 某 些 较为 复杂 的 字段 〈 如 
DateTimeField) 也 可 通过 简单 的 界面 予以 显示 ， 如 JavaScript 日 期 选择 器 。 
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填写 字段 并 单 击 SAVE 按钮 。 随 后 ， 用 户 将 被 重 定向 至 帖子 列表 页 面 ， 并 包含 一 条 
成 功 消息 以 及 刚刚 创建 的 帖子 ， 如 图 1.6 所 示 。 


Django administration WELCOME ADMIN. VIEW SITE / CHANGE PASSWORD /LOG OUT 


Home » Blog » Posts 


© The post "Who was Django Reinhardt?" was added successfully. 


Select post to change 


Action: --------- 外 Go | 0of1selected 


POST 


了 ] Who was Django Reinhardt? 


1 post 


1.4.4 ”定制 模型 的 显示 方式 


本 节 考 察 管理 站 点 的 定制 方式 。 对 此 ， 可 编辑 blog 应 用 程序 的 admin.py 文件 ， 并 对 
其 予以 修改 ， 如 下 所 示 : 


from django.contrib import admin 
from .models import Post 


@admin.register (Post) 
class PostAdmin (admin.ModelAdmin): 
list display = ('title', 'slug', ‘author', 'publish', 
'status') 

这 里 ， 我 们 将 通知 Django 管理 站 点 ， 当 前 模型 通过 继承 自 ModelAdmin 的 自 定义 类 
在 管理 站 点 中 注册 ， 在 该 类 中 ， 可 包含 管理 站 点 中 与 模型 显示 方式 及 其 交互 方式 相关 的 
信息 。 相 应 地 ，list_display 属性 可 设置 希望 在 管理 对 象 列 表 页 面 中 显示 的 模型 字段 
@admin register0 装 饰 器 执行 的 函数 与 我 们 已 经 蔡 换 的 admin.site.register() 函 数 相 同 , 并 注 
册 它 所 修饰 的 ModelAdmin 类 。 

下 面 利用 更 多 选项 定制 管理 模型 ， 对 应 代码 如 下 所 示 : 
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@admin.register (Post) 
class PostAdmin (admin.ModelAdmin): 
list display = ('title’, ‘slug', author 'publish'; 
'status') 
list filter = ('status', 'created', 'publish', 'author') 
search fields = ('title', 'body') 
Prepopulated fields = {'slug': ('title',)} 
raw_id fields = ('author',) 
date hierarchy = 'Publish' 
ordering = ('status', 'publish') 


返回 至 浏览 器 并 重新 加 载 帖子 列表 页 面 ， 对 应 结果 如 图 1.7 所 示 。 


Django administration WELCOME ADMIN. VIEW SITE/ CHANGE P 


Home , Blog, Posts 


Select post to change 


ASSWORD / LOG OU 


CD 


By status 
2017 December 14 


Acton SSS [eo | oorn selecte: 
TmuE sve AUTHOR PUBUsH 


Who was Django Reinhardt? who-was-django-reinhardt admin Dec.14,2017,8:54am. yo 


Any date 
ay 


1post 


By publish 


Any 


图 1.7 


不 难 发 现 ， 在 帖子 列表 页 面 中 显示 的 字段 实际 上 是 list_display 属性 中 指定 的 字段。 
列表 页 面包 含 了 右 侧 栏 ， 并 可 通过 list_filter 属性 中 包含 的 字段 对 结果 进行 过 滤 。 另 外 ， 
页 面 中 还 显示 了 Search 栏 ， 其 原因 在 于 ， 我 们 利用 search fields 属性 定义 了 可 搜索 字段 


列表 。 在 Search 栏 下 方 是 一 个 导航 链接 ， 可 查看 日 期 层次 结构 ， 并 通过 date_ hierarchy 属 


性 予以 定义 。 除 此 之 外 ， 在 默认 状态 下 ， 帖 子安 照 Status 和 Publish 列 进行 排 
我 们 曾 利 用 ordering 属性 指定 了 默认 的 顺序 。 


序 。 之 前 ， 


接 下 来 ， 单 击 Add Post 链接 ， 并 观察 其 中 的 变化 。 当 输入 新 帖子 的 标题 后 ，slug 字 
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段 将 被 自动 填充 。 之 前 ， 我 们 曾 通知 Django 利用 prepopulated fields 属性 ， 并 根据 title 
字段 输入 结果 预 填充 slug 字段 。 此 外 ，author 字段 则 利用 搜索 微 件 予以 显示 ， 当 存在 数 
千 名 用 户 时 ， 其 伸缩 性 明显 优 于 下 拉 选 择 输入 菜单 ， 如 图 1.8 所 示 。 


1.8 


综 上 所 述 ， 仅 需 几 行 代码 ， 即 可 定制 模型 在 管理 站 点 上 的 显示 方式 。 另 外 ， 还 存在 
多 种 方式 可 定制 、 扩 展 Django 管理 站 点 ， 稍 后 将 对 此 加 以 讨论 。 


1.5 与 QuerySet 和 管理 器 协同 工作 


前 述 内容 设 置 了 一 个 全 功能 管理 站 点 ， 并 可 对 博客 内 容 进 行 处 理 。 本 节 将 讨论 如 何 
从 数据 库 中 获取 信息 并 与 其 进行 交互 。Django 设置 了 强大 的 数据 库 抽象 API， 并 以 此 方 
便 地 创建 、 获 取 、 更 新 以 及 删除 对 象 。 同时 ,Django 中 的 对 象 关系 映射 器 兼容 于 MySQL、 
PostgreSQL、SQLite 以 及 Oracle。 需 要 注意 的 是 ， 我 们 可 在 项 目的 settings.py 文件 中 的 
DATABASES 设置 项 中 定义 当前 项 目的 数据 库 。Django 可 一 次 与 多 个 数据 库 协 同 工 作 ， 
用 户 可 以 对 数据 库 路 由 器 进行 编程 ， 以 创建 自 定义 路 由 方案 。 

在 数据 模型 创建 完毕 后 ，Django 提供 了 相应 的 API 可 与 其 进行 交互 。 读 者 可 访问 
https://docs.djangoproject.com/en/2.0/ref/models/ 以 了 解 官方 文档 中 的 数据 模型 参考 内 容 。 


1.5.1 创建 对 象 


打开 终端 并 运行 以 下 命令 启动 Python shell: 
Python manage.py shell 


随后 输入 下 列 代 码 行 : 


>>> from django.contrib.auth.models import User 
>>> from blog.models import Post 
>>> user = User.objects.get (username='admin') 
>>> post = Post(title='Another post', 
slug='another-post', 
body='Post body.', 
author=user) 
>>> Post.save() 
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下 面 对 上 述 代码 的 执行 内 容 进行 简要 分 析 。 首 先 ， 我 们 通过 用 户 名 admin 获取 user 
对 象 ， 如 下 所 示 : 

user = User.objects.get (username="'admin') 

这 里 ，get0) 方 法 可 从 数据 库 中 获取 单一 对 象 。 注 意 ， 该 方法 期 望 得 到 与 查询 匹配 的 
结果 。 如 果 数 据 库 未 返回 任何 结果 ， 该 方法 将 会 抛 出 DoesNotExist 异常 ， 如 果 数 据 库 返 
本 多 条 结果 , 则 会 抛 出 MultipleObjectsReturned 异常 。 这 两 个 异常 均 为 与 执行 查询 对 应 的 、 
模型 类 的 属性 。 

随后 利用 定制 title、slug 以 及 body 创建 Post 实例 ， 并 将 之 前 检索 到 的 用 户 设置 为 帖 
子 的 作者 ， 如 下 所 示 : 


post = Post (title='RAnother post', slug="'another-post', body='Post body.', 
author=user) 


@@ 注意 : 

此 类 对 象 位 于 内 存 中 ， 且 未 实现 数据 库 的 持久 化 操作 。 

最 后 ， 利 用 save() 方 法 将 Post 对 象 保存 至 数据 库 中 ， 如 下 所 示 ; 

post.save () 

上 述 操作 在 后 台 执行 了 INSERT SQL 语句 。 前 述 内容 曾 讨论 了 在 内 存 中 创建 对 象 ， 
并 于 随后 将 其 持久 化 至 数据 库 中 。 除 此 之 外 ， 还 可 通过 create0 这 一 单一 操作 方式 创建 对 
象 ， 并 将 其 持久 化 至 数据 库 中 ， 如 下 所 示 : 


Post.objects.create (title='One more post', slug='one-more-post', body="Post 
body.', author=user) 


1.5.2 ”更 新 对 象 


下 面 修改 帖子 的 标题 ， 并 再 次 保存 对 象 ， 对 应 代码 如 下 所 示 : 


>>> Post.title = 'New title' 
>>> Post.save() 


此 处 ，save() 方 法 执行 UPDATE SQL 语句 。 


全 注意 : 


当 调 用 了 save() 方 法 后 ， 对 象 的 变化 内 容 方 能 持久 化 至 数据 库 中 。 


“20 。 Django 项 目 实例 精 解 〈 第 2 版 ) 


1.5.3 获取 对 象 


Django 对 象 关系 映 射 机 制 (ORM) 基于 QuerySet。QuerySet 表示 为 一 个 源 自 数据 库 
的 对 象 集合 ， 其 中 包含 了 多 个 过 滤器 以 对 结果 进行 限制 。 之 前 我 们 已 经 了 解 到 如 何 通过 
get() 方 法 获取 数据 库 中 的 单一 对 象 ， 并 利用 Postobjects.get0 访 问 该 方法 。 相 应 地 ， 每 个 
Django 模型 至 少 包 含 一 个 管理 器 ， 且 默认 管理 器 称 作 objects。 通 过 模型 管理 器 ， 用 户 可 
得 到 一 个 QuerySet 对 象 。 当 从 某 个 表 中 获取 所 有 的 对 象 时 ， 仅 需 使 用 默认 对 象 管理 器 上 
的 all0 方 法 即 可 ， 如 下 所 示 : 

>>> all posts = Post.objects.all() 

上 述 代码 显示 了 QuerySet 的 创建 方式 ， 并 返回 数据 库 中 的 全 部 对 象 。 注 意 ， 该 
QuerySet 尚未 被 执行 。Django 中 的 QuerySet 具有 延迟 特征 ,， 仅 在 强制 操作 下 方 得 以 被 执 
行 ， 这 种 行为 使 得 QuerySet 更 加 高 效 。 如 果 未 将 QuerySet 设置 为 某 个 变量 ， 而 是 直接 将 
其 写 入 Python shell 中 ，QuerySet 的 SQL 语句 将 被 执行 一 一 此 处 将 其 强制 至 输出 结果 中 ， 
如 下 所 示 : 


>>> Post.objects.all() 


1. 使 用 filter() 方 法 

当 过 滤 QuerySet 时 ， 可 使 用 管理 器 的 filter0 方 法 。 例 如 ， 可 利用 下 列 QuerySet 获得 
2017 年 中 发 布 的 全 部 帖子 : 

Post.objects.filter (publish year=2017) 

除 此 之 外 ， 还 可 通过 多 个 字段 进行 过 滤 。 例如， 可 通过 包含 用 户 名 admin 的 作者 获 
取 发 布 于 2017 年 的 所 有 帖子 ， 如 下 所 示 : 

Post.objects.filter (publish year=2017, author username='admin') 

这 相当 于 构建 链接 多 个 过 滤器 的 同一 QuerySet， 如 下 所 示 : 


Post.objects.filter(publish year=2017) \ 
.filter(author username='admin') 
Qi: 意 : 


包含 字段 查找 方法 的 查询 操作 可 采用 两 个 下 画 线 予 以 构建 ， 如 publish year; 但 同 
一 标记 也 可 用 于 相关 模型 的 访问 字段 ， 如 author username。 
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2. 使 用 exclude() 方 法 
利用 过 滤器 的 exclude() 方 法 ， 可 从 QuerySet 中 排除 特定 的 结果 。 例 如 ， 可 获取 标题 
不 包含 Why 的 、 发 布 于 2017 年 的 全 部 帖子 ， 如 下 所 示 : 


Post.objects.filter(publish year=2017) \ 
-exclude (title startswith="'Why') 


3. 使 用 order_by() 方 法 


利用 管理 器 的 order by() 方 法 ， 可 通过 不 同 的 字段 对 结果 进行 排序 。 例 如 ， 可 获取 以 
标题 排序 的 全 部 对 象 ， 如 下 所 示 : 


Post.objects.order by('title') 
这 里 ， 默 认为 升序 操作 。 当 然 ， 还 可 通过 负 号 前 缀 进行 降序 排序 ， 如 下 所 示 : 


Post.objects.order by('-title') 


1.5.4 ”删除 对 象 


如 果 希 望 删除 某 个 对 象 , 可 通过 delete0 方 法 在 对 象 实例 中 执行 这 一 操作 ,如 下 所 示 : 


post = Post.objects.get (id=1) 
post.delete() 


@@ 注意 ， 


删除 对 象 也 会 删除 ForeignKey 对 象 ( on delete 设置 为 CASCADE ) 的 依赖 关系 。 
1.5.5 评估 QuerySet 


我 们 可 以 连接 任意 多 个 过 滤器 到 一 个 QuerySet 上 , 在 QuerySet 计算 之 前 并 不 会 访问 
数据 库 。QuerySet 仅 在 以 下 场合 被 计算 : 
口 ”首次 迭代 时 。 
当 对 QuerySet 访问 时 ， 如 Post.objects.allO[:3]。 
当 对 QuerySet 缓存 时 。 
当 在 QuerySet 上 调用 repr0 或 lenO 时 。 
当 在 QuerySet 上 显 式 调用 listO 时 。 
当 在 某 个 语句 中 对 QuerySet 进行 测试 时 ， 如 bool0、or、and 或 者 if。 


DOODO DO 
| 
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1.5.6 ”创建 模型 管理 器 


如 前 所 述 ， 对 象 表示 为 每 个 模型 的 默认 管理 器 〈 可 检索 数据 库 中 的 全 部 对 象 ) 。 然 
而 ， 我 们 还 可 针对 模型 定义 定制 管理 器 。 下 面 将 创建 定制 管理 器 并 检索 包含 published 状 
态 的 全 部 帖子 。 

对 此 ， 存 在 两 种 方式 可 向 模型 中 添加 管理 器 ， 即 添加 额外 的 管理 器 方法 ， 或 者 修改 
初始 管理 器 QuerySet。 其 中 , 第 一 个 方法 提供 了 相应 的 QuerySet API, 如 Post.objects.my_ 
manager(); 而 第 二 个 方法 则 提供 了 Post.my_manager.all()。 该 管理 器 可 通过 Postpublished.all0 
检索 帖子 。 

下 面 编辑 models.py 文件 并 添加 定制 管理 器 ， 如 下 所 示 : 

class PublishedManager (models .Manager): 

def get queryset (self): 
return super (PublishedManager, 


self) .get queryset()\ 
.filter(status='published') 


class Post (models.Model) : 
2 
objects = models.Manager() # The default manager. 
Published = PublishedManager() # Our custom manager. 


管理 器 的 get_queryset0 方 法 返回 将 被 执行 的 QuerySet。 我 们 将 履 写 该 方法 ， 以 在 最 
终 的 QuerySet 中 包含 自 定 义 过 滤器 。 之 前 曾 定 义 了 定制 管理 器 ， 并 将 其 添加 至 Post 模型 
中 ， 此 处 可 对 其 加 以 使 用 并 执行 查询 。 

通过 下 列 命令 再 次 启用 开发 服务 器 : 

python manage.py shell 

此 处 可 利用 下 列 命令 检索 所 有 发 布 的 帖子 ， 其 对 应 的 标题 以 Who 开始 。 


Post.published.filter(title startswith='Who') 


1.6 构建 列表 和 详细 视图 


在 了 解 了 如 何 使 用 ORM 后 ， 即 可 着 手 准备 构建 博客 应 用 程序 的 视图 。Diango 视图 
仅 表示 为 一 个 Python 函数 ， 接 收 Web 请 求 并 返回 一 个 Web 响应 。 另 外 ， 返 回响 应 结果 
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的 全 部 逻辑 均 位 于 视图 中 。 

首先 ， 需 要 创建 应 用 程序 视图 ， 并 于 随后 针对 每 个 视图 定义 URL。 最 后 ， 还 需要 创 
建 HTML 模板 ， 以 泻 染 视图 所 生成 的 数据 。 其中， 每 个 视图 将 泻 染 一 个 模板 〈 向 其 中 传 
递 变量 ) ， 并 返回 包含 泻 染 输出 结果 的 HITP 响应 。 


1.6.1 生成 列表 和 视图 


下 面 开始 创建 视图 以 显示 帖子 列表 。 编辑 blog 应 用 程序 的 views.py 文件 , 如 下 所 示 : 


from django.shortcuts import render, get object or 404 
from .models import Post 


def post list(request): 
posts = Post.published.all () 
return render(request, 
'blog/post/list.html', 
"posts": postsi}) 
上 述 代码 创建 了 第 一 个 Django 视图 。 具 体 来 说 ，post_list 视图 接收 request 对 象 作为 
唯一 参数 。 需 要 注意 的 是 ， 全 部 视图 都 需要 使 用 到 该 参数 。 在 当前 视图 中 ， 将 利用 之 前 
创建 的 published 管理 器 ， 检 索 包含 published 状态 的 所 有 帖子 。 
最 后 ， 是 使 用 Django 提供 的 render( 方 法 泻 染 包 含 给 定 模板 的 帖子 列表 。 该 函数 接 
收 request 对 象 、 模 板 路 径 以 及 上 下 文 变量 ， 进 而 泻 染 给 定 的 模板 。 另 外 ， 该 函数 返回 包 
含 泻 染 文本 (一 般 为 HTML 代码 ) 的 HttpResponse 对 象 。render() 快 捷 方式 涉及 请 求 上 下 
文 ， 因 而 模板 上 下 文 处 理 器 设置 的 任意 变量 均 可 被 给 定 的 模板 所 访问 。 模 板 上 下 文 处 理 
器 只 是 将 变量 设置 到 上 下 文中 的 可 调用 程序 ， 第 3 章 将 对 此 加 以 讨论 。 
下 面 创建 第 二 个 视图 并 显示 独立 的 帖子 。 对 此 ， 可 向 views.py 文件 添加 下 列 函 数 : 
def post detail (request, year, month, day, post): 
post = get object or 404(Post, slug=post, 
status='published', 
publish year=year, 
publish month=month, 
publish day=day) 


return render (request, 
'blog/post/detail.html', 
人 SSE pOSEPY 
作为 帖子 的 详细 视图 ， 该 视图 接收 year、month、day 以 及 post 作为 参数 ， 并 检索 包 
含 既定 slug 和 日 期 的 发 布 帖子 。 注 意 ， 当 创建 Post 模型 时 ， 将 向 slug 字段 加 入 unique 
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for date 参数 。 通 过 这 一 方式 , 对 于 既定 日 期 , 可 确保 仅 存 在 一 个 包含 slug 的 帖子 。 


此 ， 


可 通过 日 期 和 slug 检索 单一 帖子 。 在 详细 视图 中 ， 我 们 采用 get_object_or_404() 快 捷 方 式 


检索 期 望 的 帖子 。 该 函数 检索 与 既定 参数 匹配 的 对 象 ， 或 者 ， 如 果 对 象 不 存在 ， 
HTTP 404 异常 。 最 后 ， 我 们 使 用 render(0) 快 捷 方 式 并 通过 模板 泻 染 检索 到 的 帖子 。 


1.6.2 ”向 视图 添加 URL 路 径 


则 抛 出 


URL 路 径 可 将 URL 映射 至 视图 上 。 有 具体 来 说 ，URL 路 径 由 字符 串 路 径 、 视 图 和 可 
在 项 目 范围 内 命名 URL 的 名 称 〈 可 选 ) 组 成 。Django 遍历 每 个 URL 路 径 ， 并 在 第 一 个 
与 请 求 URL 匹配 的 路 径 处 停止 。 随 后 ，Dijango 导入 与 URL 路 径 匹 配 的 视图 并 对 其 加 以 


执行 、 传 递 HttpRequest 类 实例 和 关键 字 〈 或 者 位 置 参数 ) 。 
下 面 在 blog 应 用 程序 目录 的 urlspy 文件 中 添加 下 列 代码 行 : 


from django.urls import path 
from . import views 


app name = 'blog' 


urlpatterns = [ 
# post views 
path('', views.post list, name='post list'), 
path('<int:year>/<int:month>/<int:day>/<slug:post>/', 
Views.post detail, 
name='post detail'), 


] 


在 上 述 代 码 中 , 通过 app_name 变量 定义 了 应 用 程序 命名 空间 ， 并 可 通过 应 用 程序 组 


织 URL， 并 在 引用 时 使 用 对 应 名 称 。 这 里 通过 path0 函 数 定义 了 两 种 不 同 的 路 径 。 


其 中 ， 


第 一 个 URL 路 径 不 接收 任何 参数 ， 并 映射 至 post_list 视图 。 第 二 个 路 径 接收 下 列 4 个 参 


数 ， 并 映射 至 post_detail 视图 上 。 
口 year 表示 为 一 个 整数 。 
口 month 表示 为 一 个 整数 。 
口 day 表示 为 一 个 整数 。 
口 “post 由 单词 和 连 字符 组 成 。 


此 处 , 我们 使 用 尖 括 号 捕捉 URL 值 .任何 定义 于 URL 路 径 中 的 值 ( 形 如 <parameter>) 
均 作为 字符 串 被 捕捉 。 我 们 将 使 用 路 径 转 换 器 (如 <int:year>〉 以 实现 特定 的 匹配 ， 并 返 
回 一 个 整数 和 <slug:post>， 且 与 slug 实现 特定 的 匹配 (由 ASCII 字母 、 数 字 、 连 字符 和 
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下 画 线 构成 的 字符 串 ) 。 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/http/urls/ 
加 ath-converters， 并 查看 Django 提供 的 全 部 路 径 转换 器 。 

如 果 path0 和 转换 器 无 法 满足 当前 要 求 ， 则 可 采用 re_path0 定 义 包含 Python 正则 表 
达 式 的 复杂 URL 路 径 。 关 于 包含 正则 表达 式 的 URL 路 径 定 义 ， 读 者 可 访问 https://docs. 
djangoproject.com/en/2.0/ref/urls/#django.urls.re_ path 以 了 解 更 多 内 容 。 如 果 之 前 读者 尚未 
接触 过 正则 表达 式 ， 则 可 首先 参考 Regular Expression HOWTO， 对 应 网 址 为 https://docs. 
python.org/3/howto/regex.html。 

食 提 未: 

针对 每 个 应 用 程序 创建 urls.py 文件 可 视 为 应 用 程序 复 用 的 一 种 最 佳 方式 。 

目前 ， 需 要 在 项 目的 主 URL 路 径 中 包含 blog 应 用 程序 的 URL 路 径 。 对 此 ， 可 编辑 
位 于 项 目 mysite 目录 中 的 urls.py 文件 ， 如 下 所 示 : 


from django.urls import path, include 
from django.contrib import admin 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('blog/', include('blog.urls', namespace='blog')), 
] 
利用 include 定义 的 新 URL 路 径 引 用 了 定义 于 blog 应 用 程序 中 的 URL 路 径 , 因而 包 
含 于 blog/ 路 径 中 。 另 外 ， 此 类 路 径 还 位 于 命名 空间 blog 中 。 此 外 ， 命 名 空间 须 在 整个 项 
目 中 保持 唯一 。 稍 后 , 我 们 即 可 方便 地 引用 blog URL, 如 blog:post_list 和 blog:post_detail。 
关于 URL 命名 空间 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/http/urls/ 
#urlnamespaces 以 了 解 更 多 内 容 。 


1.6.3 ”模型 的 标准 URL 


我 们 可 以 使 用 1.6.2 节 定 义 的 post_detail URL 针对 Post 对 象 构建 标准 URL ,在 Django 
中 ， 对 应 规则 可 描述 为 : 向 返回 对 象 的 标准 URL 的 模型 中 添加 get_absolute_url() 方 法 。 
针对 该 方法 ， 我 们 将 使 用 reverse() 方 法 ， 并 可 通过 对 应 的 名 称 和 所 传递 的 可 选 参数 构建 
URL。 对 此 ， 可 编辑 models py 文件 并 添加 下 列 内 容 : 


from django.urls import reverse 


class Post (models.Model) : 
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: 
def get absolute url(self): 
return reverse('blog:post detail', 
args=[self.publish.year, 
self.publish.month, 
self.publish.day, 
self.slug]) 


我 们 可 使 用 模板 中 的 get_absolute_url0 方 法 ， 进 而 链接 至 特定 的 帖子 。 
1.7 创建 视图 模板 


前 述 内 容 针 对 blog 应 用 程序 创建 了 视图 和 URL， 下 面 将 添加 模板 ， 并 以 用 户 友 好 的 
方式 显示 帖子 。 
接 下 来 ， 在 blog 应 用 程序 目录 中 创建 下 列 目录 和 文件 : 
templates/ 
blog/ 
base.html 
post/ 
list.html 
detail.html 


上 述 结构 将 表示 模板 的 文件 结构 。 其 中 , base.html 文件 包含 了 站 点 的 HTML 主 结构 ， 
并 将 内 容 划 分 为 主 内 容 区 域 和 侧 栏 。list.html 和 detail.html 文件 继承 自 base.html 文件 , 分 
别 用 于 演 染 博客 帖子 列表 以 及 详细 视图 。 

Django 包含 了 功能 强大 的 模板 语言 ， 并 可 确定 数据 的 显示 方式 。 该 语言 基于 模板 标 
签 、 模 板 变 量 以 及 模板 过 滤器 ， 如 下 所 示 : 

口 ”模板 标签 负责 控制 模板 的 演 染 ， 形 如 {% tag %}。 

口 ” 当 模板 被 演 染 时 ， 模 板 变量 被 蔡 换 为 对 应 值 ， 形 如 {{ variable }}。 

口 模板 过 滤器 可 针对 显示 调整 变量 ， 形 如 { {variable | filter }}。 

读者 可 访问 https://docs.djangoproject.com/en/2.0/ref/templates/builtins/， 以 查看 全 部 内 
建 的 模板 标签 和 过 滤器 。 

下 面 编辑 base.html 文件 并 添加 下 列 内 容 : 

{% load static %} 


<!DOCTYPE html> 
<html> 
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<head> 
<title>{% block title %}{% endblock %}</title> 
<link href="{% static "css/blog.css" $}" rel="stylesheet"> 
</head> 
<body> 
<div id="content"> 
{% block content %} 
{$$ endblock $} 
</div> 
<div id="sidebar"> 
<h2>My blog</h2> 
<p>This is my blog.</p> 
</div> 
</body> 
</html> 


其 中 ，{% load static %} 通 知 Django 加 载 django.contrib.staticfiles 应 用 程序 提供 的 静 
态 模 板 标签 ， 该 标签 位 于 INSTALLED_APPS 设置 项 中 。 待 加 载 完 毕 后 ， 可 在 模板 中 使 
用 {% static %} 模 板 过 滤器 。 根 据 这 一 模板 过 滤器 ， 即 可 包含 静态 文件 ， 如 blog.css 文件 

(该 文件 位 于 blog 应 用 程序 的 static/ 目 录 下 ) 。 随 后 ， 可 将 本 章 示例 代码 的 static/ 目 录 复 
制 到 项 目的 同一 位 置 ， 以 使 用 CSS 样式 表 。 

通过 观察 可 知 ， 此 处 存在 两 个 {% block %} 标 签 。 此 类 标签 通知 Django， 需 要 在 该 区 
域内 定义 一 个 块 。 继 承 自 该 模板 的 模板 将 利用 相关 内 容 填 充 该 块 。 此 处 分 别 定义 了 title 
块 和 content 块 。 

下 面 编辑 post/list.html 文件 ， 对 应 内 容 如 下 所 示 : 


{% extends "blog/base.html" $} 
{$$ block title %}My Blog{% endblock %} 


{% block content %} 
<hl>My Blog</h1l> 
{ 当 for post in posts %} 
<h2> 
<a href="{{ post.get absolute url }}"> 
{{ post.title }} 
</a> 
</h2> 
<p class="date”> 
Published {{ post.publish }} by {{ post.author }} 
</p> 
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{{ post.bodyltruncatewords:30|linebreaks }} 
{$$ endfor %} 

{$$% endblock %} 

根据 {% extends %} 模 板 标 签 ， 将 通知 Django 继承 blog/base.html 模板 。 随 后 ， 将 填 
充 基 模板 的 title 和 content 块 。 接 下 来 将 遍历 帖子 ， 并 显示 标题 、 日 期 、 作 者 、 主 体内 容 ， 
还 包括 标题 中 指向 帖子 标准 URL 的 链接 。 在 帖子 的 主体 内 容 中 , 可 使 用 两 个 模板 过 滤器 。 
其 中 ，truncatewords 将 数值 截取 至 特定 的 单词 数量 ，linebreaks 将 输出 结果 转换 为 HTML 
换行 符 。 当 然 ， 我 们 可 以 连接 任意 数量 的 模板 过 滤器 ， 每 个 过 滤器 都 将 应 用 于 前 一 个 过 
滤器 生成 的 输出 结果 中 。 

打开 Shell 并 执行 python manage.py runserver 命令 ， 以 启动 开发 服务 器 。 在 浏览 器 中 
输入 http:/127.0.0.1:8000/blog/ 即 可 看 到 当前 运行 状态 。 需 要 注意 的 是 ， 此 处 需要 设置 一 
些 包含 Published 状态 的 帖子 ， 以 对 其 加 以 显示 。 对 应 结果 如 图 1.9 所 示 。 


127.0.0.1:8000/blog/ 


My Blog My blog 


This is my blog. 


Who was Django Reinhardt? 


Who was Django Reinhardt. 


Another post 


Post body. 


图 1.9 
接 下 来 开始 编辑 post/detail.html 文件 ， 如 下 所 示 : 
{s extends "blog/base.html" %} 


{ 当 block title %}{{ post.title }}{% endblock $} 


{$$ block content %} 
<hl>{{ post.title }}</hl> 
<p classs="daten> 
Published {{ post.publish }} by {{ post.author }} 
</p> 
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{{ post.body|llinebreaks }} 
{ 和 要 endblock $$} 


随后 可 返回 至 浏览 器 中 ， 单 


帖子 标题 以 查看 帖子 的 详细 视图 ， 如 图 1.10 所 示 。 


127.0.0.1:8000/blog/2017/12/14/who-was-django-reinhardt| CC 


Who was Django Reinhardt? 


My blog 
This is my blog. 
Who was Django Reinhardt. 


图 1.10 


查看 URL 一 一 其 对 应 结果 应 为 /blog/2017/12/14/who-was-djangoreinhardt/。 对 于 博客 
中 的 帖子 ， 我 们 已 经 设计 了 SEO 友好 的 URL。 


1.8 添加 分 页 机 制 


当 开 始 向 博客 中 添加 内 容 时 ， 我 们 很 快 就 会 意识 到 ， 需 要 在 多 个 页 面 中 分 隔 帖 子 列 
表 。Django 包含 了 内 建 的 分 页 类 ， 从 而 可 方便 地 管理 分 页 数据 。 
编辑 blog 应 用 程序 的 views.py 文件 ， 导 入 Django 的 分 页 器 类 并 调整 post_list 视图 ， 
如 下 所 示 : 
from django.core.paginator import Paginator, EmptyPage,\ 
PageNotAnInteger 


def post list(request): 

object list = Post.published.all () 

Paginator = Paginator (object list, 3) # 3 posts in each Page 

page = request.GET.get('page') 

try: 
posts = paginator.page (page) 

except PageNotAnInteger: 
# If page is not an integer deliver the first page 
posts = paginator.page(1) 

except EmptyPage: 
# If page is out of range deliver last page of results 
posts = paginator.page (Paginator .num pages) 

return render (request, 
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'blog/post/1list.html', 
{'page': page, 
"postsr: posts}) 
分 页 机 制 的 工作 方式 如 下 所 示 : 
(1) 利用 每 个 页 面 上 显示 的 对 象 数量 实例 化 Paginator 类 。 
(2) 获取 表示 当前 页 面 号 的 page GET 参数 。 
(3) 调用 Paginator 的 page() 方 法 获得 所 需 页 面 的 对 象 。 

(4) 如 果 page 参数 并 非 是 一 个 整数 ， 我 们 将 检索 结果 的 第 一 个 页 面 。 如 果 该 参数 
数值 大 于 最 后 一 个 页 面 ， 则 检索 最 后 一 个 页 面 。 
(5) 向 模板 传递 页 面 号 以 及 检索 对 象 。 

另外 ， 还 需要 创建 一 个 模板 以 显示 分 页 器 ， 以 使 其 包含 于 使 用 分 页 机 制 的 任意 模板 
中 。 在 blog 应 用 程序 的 templates/ 文 件 夹 中 ， 创 建 一 个 新 文件 ， 将 其 命名 为 pagination html， 
并 向 该 文件 中 添加 下 列 HTML 代码 : 
<div class="pagination"> 
<span class="step-links"> 
{% if page.has previous %} 
<a href="?page={{ page.previous page number }}">Previous</a> 
{% endif %} 
<span class="current"> 
Page {{ page.number }} of {{ page.paginator.num pages }}. 
</span> 
{% if page.has next %} 
<a href="?page={{ page.next page number }}">Next</a> 
{% endif %} 
</span> 
</div> 
分 页 模板 期 望 接收 一 个 Page 对 象 ， 以 泻 染 上 一 个 和 下 一 个 链接 ， 并 显示 结果 的 当前 
页 和 全 部 页 。 下 面 返回 至 blog/post/list.html 模板 ， 并 在 {% content %} 块 下 方 包含 
pagination.html 模板 ， 如 下 所 示 : 


{ 当 block content $%} 


人 "pagination.html" with page=posts %} 
{ 当 endblock $} 
由 于 传递 至 模板 的 Page 对 象 称 作 posts, 因而 可 在 帖子 列表 模板 中 包含 分 页 模板 ,经 
参数 传递 后 实现 正确 的 泻 染 。 此 外 ， 可 遵循 这 一 方法 并 在 不 同 模型 的 分 页 视图 中 复 用 分 
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页 模板 。 


在 浏览 器 中 输入 http://127.0.0.1:8000/blog/， 随 后 可 看 到 帖子 列表 下 方 的 分 页 功能 ， 


如 图 1.11 所 示 。 


127.0.0.1:8000/blog/ 


My Blog 


My blog 
This is my blog. 


Miles Dewey Davis Ill was an American jazz trumpeter, bandleader and 
composer. 


Notes on Duke Ellington 


Edward Kennedy "Duke" Ellington was an American composer, pianist, and 
bandleader of a jazz orchestra. 


Another post 
Post body. 
Page 1 of 2. Next 


图 1.11 
1.9 使 用 基于 类 的 视图 


基于 类 的 视图 是 将 视图 实现 为 Python 对 象 〈 而 非 函 数 ) 的 另 一 种 方案 。 由 于 视图 表 


示 为 一 种 可 调用 的 程序 ， 接 收 Web 请 求 并 返回 Web 响应 ， 因 而 可 将 视图 定义 为 类 方法 。 
Django 对 此 提供 了 视图 基 类 ， 且 均 继 承 自 View 类 ， 并 用 于 处 理 HITP 方法 调度 和 其 他 
常见 功能 。 


六 


对 于 某 些 应 用 场合 来 说 ， 基 于 类 的 视图 优 于 基于 函数 的 视图 ， 主 要 体现 在 以 下 几 个 


口 在 独立 的 方法 中 组 织 与 HTTP 方法 相关 的 代码 ， 如 GET、POST 或 PUT。 
口 采用 多 重 继 承 创建 可 复 用 的 视图 类 (也 称 作 混入 类 ) 。 
关于 基于 类 的 视图 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/class- 


based-views/intro/ 以 了 解 更 多 内 容 。 
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将 把 post_list 视图 修改 为 基于 类 的 视图 ， 并 使 用 Django 提供 的 通用 ListView。 


。32 。 
下 面 

这 一 基 视 图 可 显示 任意 类 型 的 对 象 。 
编辑 


blog 应 用 程序 的 views.py 文件 ， 并 添加 下 列 代码 : 


from django.views.generic import ListView 


class PostListView(ListView) : 


基于 
列 操作 : 
口 


口 


口 
口 


queryset = Post.published.all() 
context object name = "posts'" 
paginate by = 3 

template name = 'blog/post/list.html' 


类 的 视图 类 似 于 之 前 的 post_list 视图 。 在 上 述 代码 中 ， 将 通知 ListView 执行 下 


使 用 特定 的 QuerySet， 而 不 是 检索 全 部 对 象 。 此 处 并 未 定义 queryset 属性 ， 而 
是 采用 了 特定 的 model = Post，Django 将 为 我 们 构建 通用 的 Post.objects.all0) 
QuerySet。 

针对 查询 结果 使 用 上 下 文 变量 posts。 如 果 未 指定 context_object_name， 那 么 默 
认 变量 为 object_list。 

最 终结 果 经 分 页 后 将 显示 3 个 对 象 /页 。 

使 用 自 定 义 模 板 泻 染 当 前 页 面 。 如 果 未 设置 默认 模板 ，ListView 将 使 用 
blog/post_listhtml。 


下 面 打开 blog 应 用 程序 的 urls.py 文件 ， 注 释 掉 之 前 的 post_list URL 路 径 ， 并 通过 
PostListView 类 添加 新 的 URL 路 径 ， 如 下 所 示 : 


urlpatterns = [ 


] 


ListView 


为 了 保持 分 页 机 制 ， 须 使 用 传递 至 模板 中 的 正确 的 页 面 对 象 。Django 中 的 通用 视 
通 


# post views 
# path('', views.post list, name='post list'), 
path('', views.PostListView.as view(), name='post list'), 
path('<int:year>/<int:month>/<int:day>/<slug:post>/', 
views.post detail, 
name='post detail'), 


将 所 选 页 面 传递 至 page_obj 变量 中 。 对 此 ， 须 编辑 post/list.html 模板 ， 并 i 


正确 的 变量 设置 分 页 器 ， 如 下 所 示 : 


{s include "pagination.html" with page=page obj $} 
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在 浏览 器 中 打开 http://127.0.0.1:8000/blog/， 并 验证 显示 结果 是 否 与 之 前 的 post_list 
视图 保持 一 致 。 作 为 基于 类 的 视图 ， 这 一 简单 示例 使 用 了 Django 提供 的 通用 类 。 第 10 
章 以 及 后 续 章 节 还 将 对 基于 类 的 视图 展开 深入 讨论 。 


1.10 本 章 小 结 


本 章 通 过 基本 的 博客 程序 ， 讨论 了 Django Web 框架 的 基础 知识 。 针 对 该 项 目 ， 我们 
设计 了 数据 模型 并 采用 了 迁移 操作 。 其 中 涉及 视图 、 模 板 、URL 以 及 分 页 机 制 。 

第 2 章 将 进一步 完善 博客 应 用 程序 ， 其 中 包括 评论 系统 以 及 标签 功能 ， 此 外 ， 用 
还 可 通过 电子 邮件 共享 帖子 。 


把 


第 2 章 利用 高 级 特性 完善 博客 程序 


第 1 章 创建 了 基本 的 博客 应 用 程序 ， 本 章 将 讨论 一 些 较为 高 级 的 特性 ， 以 进一步 完 
善 该 程序 的 各 项 功能 ， 如 通过 电子 邮件 共享 帖子 、 添 加 评论 功能 、 对 帖子 添加 标签 ， 以 
及 按照 相似 性 检索 帖子 。 本 章 主 要 包含 以 下 内 容 : 

口 利用 Django 发 送 电子 邮件 。 
创建 表单 并 在 视图 中 对 其 加 以 处 理 。 
从 模型 中 创建 表单 。 
整合 第 三 方 应 用 程序 。 
构建 复杂 的 QuerySet。 


DOODO 


2.1 通过 电子 邮件 共享 帖子 


用 户 应 可 通过 发 送 邮 件 共享 帖子 。 结 合 第 1 章 的 内 容 ， 我 们 需要 考察 视图 、URL 以 
及 模板 的 应 用 方式 ， 进 而 实现 这 一 功能 。 针 对 帖子 的 邮件 发 送 功能 ， 需 要 执行 以 下 操作 ; 

口 ”创建 用 户 表单 ， 并 填写 名 字 、 电 子 邮件 、 收 件 人 以 及 可 选 的 备注 功能 。 

口 在 views.py 文件 中 创建 视图 ， 并 处 理 数 据 以 及 发 送 邮 件 。 

口 在 blog 应 用 程序 的 urls.py 文件 中 ， 针 对 新 视图 添加 URL 路 径 。 

口 ”创建 模板 并 显示 表单 。 


2.1.1 利用 Django 创建 表单 


本 节 开 始 着 手 构建 表单 以 共享 帖子 。Django 包含 了 内 建 的 表单 框架 ， 并 可 通过 一 种 
简单 的 方式 生成 表单 。 该 表单 框架 可 定义 表单 字段 、 指 定 显示 方式 ， 以 及 如 何 验 证 输入 
数据 。 此 外 ，Django 表单 框架 还 提供 了 一 种 灵活 的 方式 泻 染 表单 和 处 理 数据 。 

Django 包含 两 个 基 类 可 构建 表单 ， 如 下 所 示 : 

口 、Form 可 构建 标准 的 表单 。 

口 ”ModelForm 可 构建 与 模型 实例 相关 联 的 表单 。 

接 下 来 ， 首 先 在 blog 应 用 程序 目录 中 创建 forms.py 文件 ， 如 下 所 示 : 
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from django import forms 


class EmailPostForm(forms .Form) : 
name = forms.CharField (max length=25) 
email = forms .EmailField() 
to = forms.EmailField() 
comments = forms .CharField(required=False， 
widget=forms .Textareal) 
上 述 代码 表示 为 第 一 个 Django 表单 ， 其 中 ， 通 过 继承 Form 基 类 创建 了 一 个 表单 。 
相应 地 ， 我 们 可 针对 Django 使 用 不 同 的 字段 类 型 以 验证 字段 。 


@ 注意 ; 
表单 可 位 于 Django 项 目 中 的 任意 位 置 。 相 关 规 则 描述 为 : 可 将 表单 置 于 每 个 应 用 
程序 的 forms.py 文件 中 。 


这 里 ，name 字段 表示 为 CharField。 该 字段 类 型 显示 为 <input type="text"> HTML 元 
素 。 另 外 ， 每 个 字段 类 型 均 包 含 默认 的 微 件 ， 进 而 指定 字段 在 HTML 的 表现 方式 。 相 应 
地 ， 默 认 的 微 件 可 通过 widget 属性 被 覆 写 。 在 comments 字段 中 ， 我 们 使 用 了 Textarea 
微 件 将 其 显示 为 <textarea> HTML 元素， 而 非 默 认 状态 下 的 <input> 元 素 。 

另外 ， 字段 验证 还 取决 于 字段 类 型 。 例 如 ，email 和 to 字段 均 为 EmailField 字段 ， 两 
个 字段 需要 使 用 到 有 效 的 电子 邮件 地 址 ， 否 则 ， 字 段 验证 将 抛 出 forms.ValidationError 异 
常 ， 且 对 应 表单 将 不 会 被 验证 。 对 于 表单 验证 来 说 ， 有 时 还 需要 考察 其 他 参数 。 例 如 ， 
针对 name 字段 定义 了 25 个 字符 的 最 大 长 度 ， 利用 required=False 将 comments 设置 为 可 
选项 等 。 这 些 都 涉及 字段 验证 行为 。 表 单 中 所 用 的 字段 类 型 仅 表示 为 Django 表单 字段 中 
的 一 部 分 内 容 。 读 者 可 访问 https://docs.djangoproject.com/en/2.0/ref/forms/fields/， 以 了 解 
有 效 的 表单 字段 列表 。 


2.1.2 “处理 视图 中 的 表单 


本 章 将 创建 新 的 表单 并 对 其 加 以 处 理 ， 当 提交 成 功 后， 将 发 送 一 封 电子 邮件 。 对 此 ， 
编辑 blog 应 用 程序 中 的 views.py 文件 ， 并 添加 下 列 代码 : 


from .forms import EmailPostForm 


def post share (request, post id) : 
# Retrieve post by id 
post = get object or 404(Post, id=post id, status='published') 
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if request.method == 'POST': 
# Form was submitted 
form = EmailPostForm(request .POST) 
if form.is valid(): 
# Form fields passed validation 
cd = form.cleaned data 
# ... send email 
else: 
form = EmailPostForm() 


return render(request, 'blog/post/share.html', {'post': 
SEOT 


上 述 视图 的 工作 方式 如 下 所 示 : 


ry 


post, 
form}) 


口 ”定义 了 post_share 视图 ， 并 接收 request 对 象 和 post_id 变量 作为 参数 。 
口 采用 get_object_or 404() 快 捷 方式 ， 并 通过 ID 检索 帖子 ， 以 确保 检索 的 帖子 包 


含 published 状态 。 


口 ” 对 于 初始 表单 的 显示 以 及 提交 数据 的 处 理 ， 这 里 使 用 了 同一 视图 。 我 们 可 根据 
request 方法 区 分 是 否 提交 表单 ， 并 使 用 POST 提交 表单 。 假 设 如 果 获 得 了 一 个 
GET 请 求 ， 将 显示 一 个 空 表单 ， 若 获得 一 个 POST 响应 ， 该 表单 将 提交 并 被 处 


。 因 此 ， 我 们 采用 request.method 一 "POST' 区 分 这 两 种 情形 。 
ee 显示 了 表单 显示 和 处 理 流程 : 


(1) 当 视 图 在 初始 时 利用 GET 请 求 被 加 载 时 ， 可 创建 一 个 新 的 form 实例 ， 并 用 于 


显示 模板 中 的 空 表 单 ， 如 下 所 示 : 


form = EmailPostForm() 


(2) 用 户 填 写 表 单 ， 并 通过 POST 予以 提交 。 随 后 ， 通 过 包含 于 request.POST 中 的 


提交 数据 生成 一 个 表单 实例 ， 如 下 所 示 : 


if request.method == 'POST': 
# Form was submitted 
form = EmailPostForm(request .POST) 


(3) 此 后 ， 将 利用 表单 的 is_valid0 端 点 验证 所 提交 的 数据 。 该 方法 将 对 表单 中 引入 
的 数据 进行 验证 ， 若 全 部 字段 均 包 含有 效 数 据 ， 则 返回 True。 如 果 任 一 字段 包含 了 无 效 
数据 ， 那 么 ，is_valid0 将 返回 False。 通 过 访问 form.errors， 读 者 可 查看 验证 错误 列表 。 


(4) 如 果 表 单 无 效 , 将 利用 所 提交 的 数据 再 次 显示 表单 ， 并 在 模板 中 显 


示 验 证 错误 。 


(5) 若 表单 正确 ， 通 过 访问 form.cleaned_data 将 对 验证 后 的 数据 进行 检索 。 该 属性 


表示 为 表单 字段 及 其 对 应 值 的 字典 。 
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@@ 注意 


车 表单 数据 未 被 验证 ，cleaned data 将 仅 包 含有 效 的 字段 。 
下 面 讨论 如 何 利用 Django 发 送 邮件 ， 并 对 相关 功能 进行 整合 。 


2.1.3 利用 Django 发 送 邮 件 


利用 Django 发 送 邮件 其 过 程 较为 直观 。 首 先 ， 需 要 设置 本 地 SMTP 服务 器 ， 或 者 定义 
外 部 SMTP 服务 器 配置 ， 也 就 是 说 ， 向 当前 项 目的 settings.py 文件 中 添加 下 列 设置 信息 。 
EMAIL HOST: 表示 SMTP 服务 器 主机 ， 默 认为 localhost。 
EMAIL PORT: 表示 SMTP 端口 ， 默 认为 25。 
EMAIL HOST _USER: 表示 SMTP 服务 器 的 用 户 名 。 
EMAIL HOST _ PASSWORD: SMTP 服务 器 的 密码 。 
EMAIL USE_TLS: 表示 是 否 采用 TLS 安全 连接 。 
EMAIL USE SSL: 表示 是 否 采用 隐 式 TLS 安全 连接 。 

若 不 支持 SMTP 服务 器 ， 则 可 通知 Django 向 控制 台 写 入 邮件 ， 即 向 settings.py 文件 
添加 下 列 设置 内 容 : 


EMAIL BACKEND = 'django.core.mail.backends.console.EmailBackend' 


通过 上 述 设置 信息 ，Django 将 所 有 的 邮件 输出 至 Shell 中 。 这 对 于 缺少 SMTP 服务 
器 的 应 用 程序 测试 十 分 有 用 。 

如 果 需 要 发 送 邮 件 ， 但 又 缺少 本 地 SMTP 服务 器 的 支持 ， 还 可 使 用 邮件 服务 提供 商 
的 SMTP 服务 器 。 下 列 示例 配置 使 用 了 Google 账户 以 及 Gmail 服务 器 : 

EMAIL HOST = 'smtp.gmail.com' 

EMAIL HOST USER = "Your account@gmail .com' 

EMAIL HOST PASSWORD = 'your password'" 


EMAIL PORT = 587 
EMAIL USE TLS = True 


运行 python manage.py shell 命令 ， 打 开 Python Shell 并 发 送 邮 件 ， 如 下 所 示 : 

>>> from django.core.mail import send mail 

>>> send mail('Django mail', 'This e-mail was sent with Django.', 

'your account@gmail.com', ['your account@gmail.com'], fail silently=False) 

send_mail() 函 数 接收 主题 、 消 息 、 发 送 者 以 及 接收 者 列表 作为 对 应 参数 。 除 此 之 外 ， 
还 可 设置 可 选 参数 fail silently=False， 如 果 邮 件 未 被 正确 地 发 送 ， 将 抛 出 一 个 异常 。 如 果 


旺 忆 所 电台 日 
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输出 结果 为 1， 则 表明 邮件 已 被 成 功 发 送 。 


如 果 利 用 上 述 配置 以 及 Gmail 发 送 邮件 ， 可 能 需要 启用 对 安全 性 较 低 的 应 用 程序 的 
访问 (https://myaccount.google.com/lesssecureapps) ， 页 面 如 图 2.1 所 示 。 


。39 。 


Some apps and devices use less secure sign-in technology, which makes your account more vulnerable 


You can turn off access for these apps, which we recommend, orturn on access if you want to use them 
despite the risks. Learn more 


Allow less secure apps: ON 


图 2.1 
下 面 开始 着 手 向 视图 中 添加 上 述 功能 。 
编辑 blog 应 用 程序 views.py 文件 中 的 post_share 视图 ， 如 下 所 示 : 
from django.core.mail import send mail 
def post_ share (request, post id): 
# Retrieve post by id 


post = get object or 404(Post, id=post id, status='published') 
sent = False 


if request.method == 'POST': 
# Form was submitted 
form = 


EmailPostForm (request .POST) 
if form.is valid(): 
# Form fields passed validation 
cd = form.cleaned data 


Ppost url = request.build absolute uril( 


post.get absolute url()) 
subject = '{} ({}) recommends you reading " 


{}"'.format(cd['name'], cd['email'], post.title) 


message = 'Read "{}" at {}\n\n{}\'s comments: 
{}'.format (post.title, post url, cd['name'], cd['comments']) 
send maill(subject, message, 


'admin@myblog .com’', 
[cd['to']]) 


sent = True 
else: 


form = EmailPostForm() 
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return render (request， 'blog/post/share-htm1'，{"post': post, 
"form' : form, 
"sent' : sent}) 


上 述 代 码 中 声明 了 sent 变量 ， 当 帖子 发 送 后 将 其 设置 为 True。 稍 后 还 将 在 模板 中 使 
该 变量 ， 并 在 表单 成 功 提交 后 显示 成 功 信 息 。 由 于 需要 在 邮件 中 包含 指向 帖子 的 链接 ， 
因而 须 通 过 get absolute_ url() 方 法 检索 帖子 的 绝对 路 径 ， 并 使 用 该 路 径 作为 requestbuild_ 
absolute_uri() 的 输入 内 容 ， 进 而 生成 完整 的 URL， 包 括 HTTP 路 径 和 主机 名 。 通 过 验证 
表单 中 的 有 效 数 据 ， 可 构建 邮件 的 主题 和 消息 主体 内 容 ， 最 终 将 邮件 发 送 至 表单 字段 to 
中 的 邮件 地 址 处 。 

当前 ， 视 图 已 较为 完备 。 这 里 不 要 忘记 向 其 中 添加 新 的 URL。 打 开 blog 应 用 程序 的 
urls.py 文件 ， 并 加 入 post_share URL 路 径 ， 如 下 所 示 : 


urlpatterns = [ 
和 
path('<int:post id>/share/', 
Views.post share, name='post share'), 


2.1.4 ”显示 模板 中 的 视图 


前 述 内 容 创 建 了 表单 ， 对 视图 进行 编程 并 添加 了 URL 路 径 。 接 下 来 ， 需 要 针对 该 视 
图 设置 模板 。 对 此 ,可 在 blog/templates/blog/post/ 目 录 中 创建 新 文件 ,将 其 命名 为 share.html 
并 添加 下 列 代码 : 


{$$ extends "blog/base.html" %} 
{% block title %}Share a post{% endblock %} 


{ 当 block content %} 
{g% if sent %} 
<hl>E-mail successfully sent</h1l> 
<p> 
"{{ post.title }}" was successfully sent to {{ form.cleaned data.to 
E> 
</p> 
{$$ else $} 
<h1l>Share "{{ post.title }}" by e-mail</hl> 
<form action="." method="post"> 
{{ form.as p }} 
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{$s csrf 七 OKen $} 
<input type="submit" value="Send e-mail"> 
</form> 
{$$ endif $%} 
{$$ endblock %} 


上 述 代 码 表 示 为 模板 以 显示 表单 或 者 一 条 成 功 消息 。 需 要 注意 的 是 ， 我 们 创建 了 
HTML 表单 元 素 ， 表 明 需 要 通过 POST 方法 予以 提交 ， 如 下 所 示 : 


<form action="." method="post"> 


随后 , 我 们 将 包含 实际 的 表单 实例 , 通知 Django 利用 as_p 方法 显示 HTML 段落 <p> 
中 的 字段 。 除 此 之 外 ， 还 需 利用 as_ul 作为 无 序列 表 显示 表单 ， 或 者 利用 as_table 作为 
HTML 表 了 予以 显示 。 如 果 需 要 显示 每 个 字段 ， 可 遍历 相关 字段 ， 如 下 所 示 : 
{%s for field in form $%$} 
<div> 
{{ field.errors }} 
{{ field.label tag }} {{ field }} 
</div> 
{% endfor %} 
{% csrf_token %} 模 板 标签 引入 了 一 个 隐藏 字 段 ， 其 中 包含 了 自动 生成 的 令 牌 ， 以 避 
免 跨 站 点 请 求 伪 造 (CSRF) 攻击 。 此 类 攻击 包括 恶意 网 站 或 程序 ， 并 扰乱 站 点 用 户 的 正 
常 操作 。 对 此 ， 读 者 可 访问 https:/www.owasp.org/index.php/Cross-Site_ Request Forgery_ 
(CSRF)， 以 获取 更 多 信息 。 
上 述 标签 生成 的 隐藏 字段 如 下 所 示 : 
<input type='hidden' name='csrfmiddlewaretoken' 
Value='26J]JKo21cEtYkGoV9z4XmJIEHLXN5LDR7 /> 


@ 注意 
默认 状态 下 ,Django 检测 所 有 的 POST 请 求 中 的 CSRF 令 牌 。 读者 应 记 住 ， 在 通过 
POST 提交 的 所 有 表单 中 ， 需 要 添加 csrf token 标签 。 


下 面 开 始 编辑 blog/post/detail.html 模板 ， 并 在 {{ postbodyllinebreaks }} 变 量 之 后 加 入 
指向 共享 帖子 的 链接 ， 如 下 所 示 : 


<p> 
<a href="{% url "blog:post share" post.id $%$}"> 
Share this post 
</a> 
</p> 
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注意 ， 此 处 通过 Django 提供 的 {% url %} 模 板 标 签 动态 地 构建 URL。 我 们 采用 了 名 
为 blog 的 命名 空间 以 及 名 为 post_share 的 URL， 并 作为 参数 传递 帖子 ID， 进 而 生成 绝对 
URL 。 
下 面 利用 python manage.py runserver 命令 启动 开发 服务 器 ， 并 在 浏览 器 中 打开 
http:/127.0.0.1:8000/blog/, 单 击 任意 一 个 帖子 的 标题 并 查看 其 详细 页 面 。 在 帖子 主体 内 容 
下 方 ， 将 会 看 到 刚刚 添加 的 链接 ， 如 图 2.2 所 示 。 


Notes on Duke Ellington 


My blog 
This is my blog. 


Edward Kennedy "Duke" Ellington was an American composer, pianist and 
bandleader of a jazz orchestra. 


图 2.2 
单 击 Share this post 链接 ， 将 会 看 到 包含 表单 〈 通 过 邮件 方式 共享 帖子 ) 的 页 面 ， 如 
图 2.3 所 示 。 


Share "Notes on Duke Ellington" by e-mail My blog 
Name: This is my blog. 


Email' 


To: 


Comments: 


P| 
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该 表单 的 CSS 样式 表 包 含 在 static/css/blog.css 文件 的 示例 代码 中 。 当 单 击 SEND 
E-MAIL 按钮 时 ,该 表单 将 被 提交 和 验证 。 如 果 所 有 字段 均 包含 了 有 效 的 数据 ,将 会 看 到 
一 条 成 功 消息 ， 如 图 2.4 所 示 。 


E-mail successfully sent 


My blog 


"Notes on Duke Ellington" was successfully sent to account@gmail.com. This is my blog. 


图 2.4 


如 果 输 入 了 无 效 数据 ， 该 表单 将 被 再 次 显示 ， 其 中 包含 了 全 部 验证 错误 信息 ， 如 图 2.5 
所 示 。 
hh H nh | 
Share "Notes on Duke Ellington" by e-mail My blog 
Name: This is my blog. 
Antonio 
se Entera valid email address. 
Email: 


invalid 


。 This field is required. 


To: 


Comments: 


图 2.5 
需要 注意 的 是 ， 一 些 现代 浏览 器 将 会 阻止 提交 空 表单 ， 或 者 包含 错误 字段 的 表单 ， 
因 在 于 ， 表 单 验 证 一 般 根 据 字 段 类 型 和 每 个 字段 的 限制 条 件 由 浏览 器 完成 。 在 当前 
示例 中 ， 表 单 不 会 被 提交 ， 且 浏览 器 针对 错误 字段 显示 对 应 的 错误 消息 。 
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截至 目前 ， 基 于 邮件 的 帖子 共享 表单 暂 告 一 段落 ， 下 面 讨论 博客 的 评论 系统 。 


2.2 构建 评论 系统 


本 节 针 对 博客 构建 评论 系统 。 其 中 ， 用 户 可 对 帖子 发 表 评 论 。 当 构建 评论 系统 时 ， 
需要 执行 下 列 操作 步 又 : 
(1) 创建 一 个 模型 以 保存 评论 内 容 。 
(2) 创建 表单 ， 从 而 可 提交 评论 内 容 并 对 数据 进行 验证 。 
(3) 添加 包含 该 表单 的 视图 ， 并 将 最 新 的 评论 内 容 添加 至 数据 库 中 。 
(4) 标记 帖子 的 详细 模板 ， 以 显示 评论 列表 和 添加 新 评论 的 表单 。 
首先 将 创建 一 个 模型 以 存储 评论 内 容 。 对 此 ， 打 开 blog 应 用 程序 的 models.py 文件 ， 
并 添加 下 列 代码 : 
class Comment (models.Model): 
post = models.ForeignKey (Post, 
on delete=models .CASCADE, 
related name='comments') 
name = models.CharField (max length=80) 
email = models.EmailField() 
body = models.TextField() 
created = models.DateTimeField(auto now add=True) 


updated = models.DateTimeField (auto now=True) 
active = models.BooleanField (default=True) 


class Meta: 
ordering = ('created',) 


def a (sotf)s 
return 'Comment by {} on {}'.format (self.name, self.post) 


上 述 代 码 表示 为 Comment 模型 ， 其 中 包含 了 ForeignKey， 以 关联 包含 单一 帖子 的 评 
论 内 容 。 这 种 多 对 一 关系 定义 于 Comment 模型 中 一 一 每 条 评论 由 一 个 帖子 生成 ， 而 每 个 
帖子 可 包含 多 条 评论 。related_name 可 对 对 应 关系 属性 进行 命名 。 待 定义 完毕 后 ， 可 通过 
comment post 检索 评论 对 象 的 帖子 ， 并 采用 post.comments.all0 检 索 某 个 帖子 的 全 部 评论 。 如 
果 未 定义 related_name 属性 ，Django 将 使 用 模型 名 称 _set 这 一 小 写 形式 (如 comment set) 
命名 相关 对 象 的 管理 器 。 
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关于 多 对 一 关系 , 读者 可 访问 https://docs.djangoproject.com/en/2.0/topics/db/examples/ 
many_to_one/ 以 了 解 更 多 内 容 。 

active 布尔 类 型 字段 通过 手动 方式 禁用 某 些 不 恰当 的 评论 ， 同 时 还 使 用 created 字段 
对 对 象 评论 进行 排序 (默认 状态 下 按照 时 间 排 序 〉。 

之 前 刚刚 创建 的 Comment 模型 尚未 同步 至 数据 库 中 。 对 此 ， 可 运行 下 列 命 令 生成 新 
的 迁移 ， 进 而 体现 创建 了 新 的 模型 。 

Python manage.py makemigrations blog 

对 应 输出 结果 如 下 所 示 : 

Migrations for 'blog': 


blog/migrations/0002 comment.py 
- Create model Comment 


Django 在 blog 应 用 程序 的 migrations/ 目 录 中 生成 了 0002_comment.py 文件 。 接 下 来 
需要 创建 相关 的 数据 库 路 径 ， 并 将 更 改 应 用 于 该 数据 库 。 相 应 地 ， 运 行 下 列 命令 并 应 用 
现 有 的 迁移 方案 。 

Python manage.py migrate 

对 应 输出 结果 如 下 所 示 : 

Applying blog.0002 comment... OK 


在 应 用 了 刚刚 构建 的 迁移 方案 后 ，blog_comment 表 将 出 现 于 当前 数据 库 中 。 

下 面 可 将 新 模型 添加 至 管理 站 点 中 ， 并 通过 简单 的 接口 对 评论 内 容 加 以 管理 。 对 此 ， 
打开 blog 应 用 程序 的 admin.py 文件 ， 导 入 Comment 模型 并 添加 ModelAdmin 类 ， 如 下 
所 示 : 


from .models import Post, Comment 


@admin.register (Comment) 

class CommentAdmin (admin .ModelAdmin): 
list display = ('name', 'email', 'post', 'created', 'active') 
list filter = ('active', 'created', 'updated') 
search fields = ('name', 'email', 'body') 


利用 python manage.py runserver 命令 启动 开发 服务 器 ， 并 在 浏览 器 中 打开 http:/127.0.0.1: 
8000/admin/。 新 模型 将 包含 于 BLOG 中 ， 如 图 2.6 所 示 。 
当前 模型 将 在 管理 站 点 中 被 注册 ， 并 可 通过 简单 的 接口 对 Comment 实例 予以 管理 。 
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Change 


Change 


2.2.1 创建 模型 中 的 表单 


本 节 将 创建 一 个 表单 ， 以 使 用 户 可 在 博客 帖子 中 进行 评论 。 注 意 ，Django 定义 了 两 
个 基 类 构建 表单 ， 即 Form 和 ModelForm。 前 述 内 容 曾 使 用 了 Form 实现 了 基于 邮件 方式 
的 帖子 共享 操作 。 在 当前 示例 中 ， 鉴 于 从 Comment 模型 中 动态 地 创建 表单 ， 因 而 需要 使 
日 ModelForm。 编 辑 blog 应 用 程序 的 forms.py 文件 ， 并 添加 下 列 代码 : 


from .models import Comment 


class CommentForm (forms .ModelForm) : 
class Meta: 
model = Comment 
fields = ('name', 'email', 'body') 
当 从 模型 中 创建 表单 时 ， 仅 需 指定 使 用 哪 一 个 模型 创建 Meta 类 中 的 表单 。Django 
将 对 当前 模型 进行 检查 ， 并 以 动态 方式 构建 表单 。 每 个 模型 字段 类 型 均 包 含 对 应 的 默认 
表单 字段 类 型 ,我 们 定义 模型 字段 的 方式 同时 也 考虑 到 了 表单 验证 。 默认 状态 下 , Django 
针对 包含 于 模型 中 的 每 个 字段 都 会 创建 一 个 表单 字段 。 然而， 通过 fields 字段 , 我 们 可 显 
式 地 通知 当前 框架 希望 在 表单 中 包含 哪些 字段 ; 或 者 采用 字段 的 exclude 列表 定义 希望 排 
除 的 字段 。 针 对 CommentForm 表单 ， 仅 需 使 用 name、email 和 body 字段 一 一 这 些 字 段 
仅 是 用 户 可 填写 的 字段 。 


2.2.2 ”处 理 视图 中 的 ModelForms 


出 于 简单 考虑 ， 我 们 将 利用 帖子 的 详细 视图 实例 化 表单 并 对 其 进行 处 理 。 对 此 ， 编 
辑 views.py 文件 ， 针 对 Comment 模型 和 CommentForm 表单 添加 导入 语句 ， 并 修改 
post_detail 视图 ， 如 下 所 示 : 


from .models import Post, Comment 
from .forms import EmailPostForm, CommentForm 
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def post detail (request, year, month, day, post): 
post = get object or 404(Post, slug=post, 
status='published', 
publish year=year, 
publish month=month, 
publish day=day) 


# List of active comments for this post 
comments = post.comments.filter (active=True) 


new_comment = None 


if request.method == 'POST': 
# A comment was posted 
comment form = CommentForm(data=request.POST) 
IE comment form.is valid(): 
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# Create Comment object but don't save to database yet 


new_comment = comment form.save (commit=False) 
# Assign the current post to the comment 
new_comment.post = post 
# Save the comment to the database 
new_comment. save() 
else: 
comment form = CommentForm() 
return render (equest， 
"blog/post/detail.html'， 
DostwaRPostcy 
'comments ' : comments, 
'new comment': new comment, 
'comment form': comment form}) 


代码 中 使 用 了 post_detail 视图 显示 帖子 及 其 评论 内 容 , 并 针对 该 帖子 力 
以 检索 所 有 的 评论 ， 如 下 所 示 : 
comments = post.comments.filter (active=True) 


我 们 从 post 对 象 开始 构建 QuerySet, 并 针对 定义 为 comments 的 相关 到 
器 (采用 Comment 模型 中 对 应 关系 的 related_name 属性 ) 。 


入 


除 此 之 外 ， 还 使 用 了 相同 的 视图 以 使 用 户 能 够 添加 新 的 评论 。 
new_comment 设置 为 None 对 其 进行 初始 化 操作 , 当 创 建新 的 评论 内 容 时 ， 


rT 


因此 ， 


将 使 


QuerySet 


\ 
囊 
泽 


通过 将 
到 该 变 


量 。 如果 视图 通过 GET 请 求 被 调用 , 将 利用 comment form = CommentForm() 构 建 表单 实 


.48 。 Django 项 目 实例 精 解 〈 第 2 版 ) 


例 。 如 果 请 求 通过 POST 实现 ， 那 么 将 采用 提交 的 数据 对 表单 实例 化 ， 并 通过 is_valid0 
方法 对 其 进行 验证 。 如 果 表 单 无 效 ， 则 利用 验证 错误 消息 显示 模板 ， 和 否则 执行 下 列 操作 : 

(1) 调用 表单 的 save() 方 法 创建 新 的 Comment 对 象 ， 并 将 其 赋予 new_comment 变 
量 中 ， 如 下 所 示 : 


new comment = comment form.save (Commit=False) 


save() 方 法 创建 表单 所 链接 的 模型 实例 ， 并 将 其 保存 至 数据 库 中 。 如 果 采 用 
commit=False 对 其 加 以 调用 ， 将 会 创建 模型 实例 ， 但 不 会 将 其 保存 至 数据 库 中 当 需 
要 在 最 终 保存 对 象 之 前 进行 修改 时 ， 这 将 十 分 有 用 ， 稍 后 将 对 此 加 以 讨论 。 


@ 注意， 


save() 方 法 仅 适 用 于 ModelForm， 而 非 Form 实例 一 一 后 者 并 未 链接 至 任何 模型 上 。 
(2) 将 当前 帖子 置 于 刚刚 创建 的 评论 中 ， 如 下 所 示 : 


new_ comment .post = post 
据 此 ， 最 新 的 评论 内 容 隶 属于 该 帖子 。 
(3) 最 后 ， 通 过 调用 save( 方 法 ， 将 最 新 的 评论 保存 至 数据 库 中 ， 如 下 所 示 ; 


new_comment .save () 


至 此 ， 当 前 视图 已 准备 就 绪 ， 并 可 显示 和 处 理 新 的 评论 内 容 。 
2.2.3 ”向 帖子 详细 模板 中 添加 评论 


前 述 内 容 实 现 了 相关 功能 ， 并 可 管理 某 个 帖子 的 评论 内 容 。 下 面 将 使 用 post/ 
detail.html 模板 执行 下 列 操作 : 

口 显示 帖子 的 全 部 评论 数量 。 

口 显示 评论 列表 。 

口 ”向 用 户 显 示 一 个 表单 ， 并 可 添加 新 的 评论 内 容 。 

首先 ， 我 们 将 添加 全 部 评论 内 容 。 对 此 ， 打 开 post/detail.html 模板 并 向 content 块 中 
添加 下 列 代码 : 

{s with comments .count as total comments %} 

<h2> 
{{ total comments }} comment{{ total comments1pluralize }} 


</h2> 
{% endwith 村 } 
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此 处 ， 我 们 在 模板 中 使 用 了 Django ORM， 并 执行 了 QuerySet 的 comments.count() 方 
法 。 需 要 注意 的 是 ，Django 模板 语言 对 于 方法 调用 并 未 使 用 括号 。{% with %} 标 签 可 将 
某 个 值 赋予 可 用 的 新 变量 中 ， 直 至 遇 到 {% endwith %} 标 签 。 


@ :tté: 


{% with %} 模 板 标签 对 于 避免 数据 库 访 问 或 者 多 次 访问 开销 较 大 的 方法 十 分 有 用 。 


取决 于 total_ comments 值 ， 我 们 使 用 pluralize 模板 过 滤器 显示 单词 comment 的 复数 
后 缀 。 其 中 ， 模 板 过 滤器 接收 所 用 的 变量 值 作为 输入 内 容 ， 并 返回 计算 后 的 结果 值 。 第 3 
章 将 对 模板 值 加 以 讨论 。 
如 果 数 值 不 为 1， 那么 ，pluralize 模板 过 滤器 将 返回 包含 字母 s 的 字符 串 。 相 应 地 ， 
前 面 的 文本 将 分 别 显 示 0 comments、1 comment 或 N comments。Django 中 涵盖 了 多 种 模 
板 标签 和 过 滤器 ， 并 可 通过 希望 的 方式 显示 相关 信息 。 
下 面 将 添加 评论 内 容 列 表 。 在 之 前 代码 的 基础 上 ， 向 post/detail.html 模板 中 加 入 下 列 
代码 ; 
{ for comment in comments %} 
<div class="comment"> 
<p class="info"> 
Comment {{ forloop.counter }} by {{ comment.name }} 
{{ comment.created }} 
</p> 
{{ comment.body|linebreaks }} 
</div> 
{S$ empty %} 
<p>There are no comments yet.</p> 
{% endfor 当 } 


代码 中 使 用 了 {% for %} 模 板 标 签 遍 历 评论 内 容 。 如 果 comments 列表 为 空 ， 将 显示 
一 条 默认 的 消息 ， 并 告知 用 户 该 帖子 尚 不 包含 任何 评论 内 容 。 另 外 ， 还 可 通过 
{{ forloop.counter }} 变 量 枚 举 评论 内 容 ， 并 在 每 次 遍历 过 程 中 包含 了 循环 计数 器 。 随 后 ， 
将 显示 发 表 评论 的 用 户 名 、 日 期 以 及 评论 的 主体 内 容 。 
最 后 ， 还 需要 显示 表单 ， 或 者 在 提交 成 功 后 显示 一 条 成 功 消息 。 在 前 述 代码 的 基础 
加 入 下 列 代码 行 : 
{% if new comment $} 
<h2>Your comment has been added.</h2> 


{SS else $} 
<h2>Add a new comment</h2> 


La 
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<form action="." method="post"> 
{{ comment form.as P }} 
{$$ csrf token $} 
<p><input type="submit" value="Add comment"></p> 
</form> 
{ 当 endif %} 


上 述 代码 较为 直观 : 如 果 new_comment 对 象 已 存在 ， 则 显示 一 条 成 功 消息 一 一 当前 
评论 内 容 已 被 成 功 地 创建 。 否则 ， 针 对 每 个 字段 将 采用 段落 <p> 元 素 显示 表单 ， 同 时 包含 
POST 请 求 所 需 的 CSRF 令 牌 。 在 浏览 器 中 打开 http://127.0.0.1:8000/blog/， 单 击 帖子 的 标 
题 以 查看 对 应 的 详细 页 面 ， 如 图 2.7 所 示 。 


Notes on Duke Ellington 


My blog 
This is my blog. 


Edward Kennedy "Duke" Ellington was an American composer, pianist, and bandleader of 
a jazz orchestra. 


Share this post 


0 comments 


There are no comments yet. 


Add a new comment 


Name: 
Email: 


Body: 


图 2.7 


利用 表单 添加 一 组 评论 ， 对 应 评论 内 容 将 以 时 间 顺 序 显示 于 帖子 的 下 方 ， 如 图 2.8 
所 示 。 
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2 comments 


Comment 1 by Antonio Dec.1 


It's very interesting. 


4, 2017, 10:08 p.m. 


Comment 2 by Bienvenida Dec. 14, 2017, 10:09 p.m. 


1didnt know that. 


在 浏览 器 中 打开 http://127.0.0.1:8000/admin/blog/comment/, 将 会 看 到 人 


图 2.8 


。S] 。 


含 所 生成 的 评 


论 列表 的 管理 页 面 。 单 击 其 中 的 一 条 评论 并 对 其 进行 编辑 ， 同 时 多 选 掉 Active 复 选 框 并 
单 击 Save 按钮 。 用 户 将 再 次 被 重 定向 至 评论 列表 处 ，ACTIVE 列 将 显示 该 评论 的 禁用 图 


标 ， 如 图 2.9 所 示 。 


Select commentto change 


Search 


PosT 


CREATED 


Antonio userl@gmail.com Notes on Duke Ellington Aug. 25, 2017, 5:08 p.m. 


Bienvenida user2@gmail.com Notes on Duke Ellington Aug. 25, 2017, 5:08 pm. 


2comments 


图 2.9 


如 果 返 回帖 子 的 详细 视图 ， 将 会 注意 到 被 删除 后 的 评论 内 容 将 不 再 显示 ， 同 时 也 不 


会 被 计 入 评论 总 数 。 对 于 active 字段 ， 用 户 可 禁用 不 适宜 的 评论 ， 进 而 避免 将 其 显示 于 


帖子 中 。 


2.3 添加 标签 功能 


在 实现 了 评论 系统 后 ， 下 面 将 设置 一 种 方式 并 对 帖子 添加 标签 。 对 此 ， 可 


[将 第 三 方 


Django 标签 应 用 程序 整合 至 当前 项 目 


ph。django-taggit 模块 是 一 个 可 各 


下 复 使 


的 应 用 程 
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序 ， 主 要 提供 了 一 个 Tag 模型 和 一 个 管理 器 ， 进 而 可 方便 地 向 项 目 中 添加 标签 。 读 者 可 
访问 https://github.com/alex/django-taggit 查看 其 源 代码 。 
首先 ， 通 过 运行 下 列 命令 以 及 pip 可 安装 django-taggit。 


Pip install django taggit==0.22.2 


随后 ,打开 mysite 项 目的 settings.py 文件 ， 并 将 taggit 添加 至 INSTALLED _APPS 设 
置 中 ， 如 下 所 示 : 
INSTALLED APPS = [ 
,| 
'blog.apps.BlogConfig', 
'taggit', 
] 
打开 blog 应 用 程序 的 models.py 文件 ， 通 过 下 列 代码 ， 将 django-taggit 提供 的 
TaggableManager 管理 器 添加 至 Post 模型 中 ， 如 下 所 示 : 
from taggit.managers import TaggableManager 
class Post (models.Model): 


Ts 
tags = TaggableManager () 


tags 管理 器 从 Post 对 象 中 添加 、 检 索 以 及 移 除 标 签 。 
对 于 模型 的 变化 ， 可 运行 下 列 命令 生成 迁移 。 
Python manage.py makemigrations blog 
对 应 的 输出 结果 如 下 所 示 : 
Migrations for 'blog': 
blog/migrations/0003 post tags.py 
- Add field tags to post 
运行 下 列 命令 , 将 针对 django-taggit 模型 创建 所 需 的 数据 库 表 , 并 对 模型 的 变化 内 容 
实现 同步 操作 。 


Python manage.PY migrate 
对 应 的 输出 结果 表示 迁移 执行 完毕 ， 如 下 所 示 : 


Applying taggit.0001 initial... OK 
Applying taggit.0002 auto 20150616 2121... OK 
Applying blog.0003 post tags... OK 
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当前 , 数据 库 已 可 使 用 django-taggit 模型 。 下 面 考察 如 何 使 用 tags 管理 器 。 利用 python 
manage.py shell 命令 打开 终端 。 首 先 需要 检索 某 个 帖子 〈 此 处 ， 其 了 D 为 1) ， 对 应 代码 
如 下 所 示 : 


>>> from blog.models import Post 
>>> Post = Post.objects .get(id=1) 


随后 ， 向 其 添加 标签 并 检索 其 标签 ， 以 检查 它们 是 否 已 被 成 功 地 添加 ， 如 下 所 示 : 


>>> post.tags.add('music', 'jazz', 'django') 
>>> post.tags.all() 
<QuerySet [<Tag: jazz>, <Tag: music>, <Tag: django>]> 


最 后 ， 移 除 标 签 并 再 次 检查 标签 列表 ， 如 下 所 示 : 

>>> post.tags.remove('django') 

>>> post.tags.all() 

<QuerySet [<Tag: jazz>, <Tag: music>]> 

上 述 过 程 较为 简单 。 运 行 python manage.py runserver 命令 ， 再 次 启动 开发 服务 器 ， 
并 在 浏览 器 中 打开 http://127.0.0.1:8000/admin/taggit/tag/。 如 图 2.10 所 示 是 包含 taggit 应 用 
程序 的 Tag 对 象 列表 的 管理 页 面 。 


[DJllalele) administration WELCOME, ADMIN. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Home ,Taggit Tags 


Select Tag to change 


Ql 


Action: $1 Go | 0 of3 selected 
NAME SLuG 
django django 
jazz jazz 
music 


3Tags 


图 2.10 
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访问 http://127.0.0.1:8000/admin/blog/post/， 单 击 某 个 帖子 并 对 其 进行 编辑 。 此 时 将 会 
看 到 ， 帖 子 中 包含 了 Tags 字段 ， 并 可 于 其 中 方便 地 对 标签 进行 编辑 ， 如 图 2.11 所 示 。 


jazz, music 


Acomma-separated list of tags 


pd 
下 面 开始 编辑 博客 帖子 并 显示 标签 。 对 此 ， 打 开 blog/post/list.html 模板 ， 并 在 帖子 标 
题 下 方 添加 下 列 HTML 代码 ， 如 下 所 示 : 
<p class="tags">Tags: {{ post.tags.allljoin:", " }}</p> 
join 模板 过 滤器 的 工作 方式 类 似 于 Python 字符 串 的 join() 方 法 , 并 添加 包含 即 定 字符 
串 的 相关 元 素 。 在 浏览 器 中 打开 http://127.0.0.1:8000/blog/， 如 图 2.12 所 示 为 每 个 帖子 标 
题 下 方 的 标签 列表 。 


Who was Django Reinhardt? 


Tags: jazz, music 


图 2.12 
下 面 编辑 post_list 视图 ， 以 使 用 户 能 够 列 出 包含 特定 标签 的 全 部 帖子 。 打开 blog 应 用 
显 序 的 views.py 文件 ， 导 入 django-taggit 中 的 Tag 模型 并 修改 post list 视图 ， 如 下 所 示 : 
from taggit.models import Tag 
def post list(request, tag_slug=None): 


object list = Post.published.all() 
tag = None 


if tag _ slug: 
tag = get object or 404(Tag, slug=tag slug) 
object list = object list.filter(tags in=[tag]) 


paginator = Paginator (object list, 3) # 3 posts in each page 
考 -= 
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post_list 视图 的 工作 方式 如 下 所 示 : 
(1) post_list 接收 可 选 的 tag_slug 参数 ， 该 参数 的 默认 值 为 None 并 包含 于 URL 中 。 
(2) 在 当前 视图 中 ， 我 们 构建 初始 的 QuerySet、 检 索 发 布 的 全 部 帖子 ， 如 果 存 在 即 
定 的 标签 slug， 将 通过 get_object_or 4040 快 捷 方式 并 利用 给 定 的 slug 获得 Tag 对 象 。 
(3) 随后 ， 通 过 slug (包含 了 给 定 的 slug) 过 滤 帖子 列表 。 考 虑 到 多 对 多 关系 ， 我 
们 需要 通过 包含 于 给 定 列表 中 的 标签 进行 过 滤 ， 当 前 示例 中 仅 包含 了 一 个 元 素 。 
需要 注意 的 是 ，QuerySet 具有 延迟 特征 ， 因 此 ， 仅 当 显示 模板 同时 饥 历 帖子 列表 
方 执行 检索 帖子 的 QuerySet。 
最 后 ， 调 整 视图 下 方 的 render0 函 数 ， 并 将 tag 变量 传递 至 当前 模板 中 。 对 应 视图 如 
下 所 示 : 
def post list(request, tag slug=None): 


object list = Post.published.all() 
tag = None 


i 


if tag slug: 
tag = get object or 404(Tag, slug=tag slug) 
object list = object list.filter(tags in=[tag]) 


paginator = Paginator (object list, 3) # 3 posts in each page 
page = request.GET.get ('page') 
Es 
posts = paginator.page (page) 
except PageNotRAnInteger: 
# If page is not an integer deliver the first page 
posts = paginator.page (1) 
except EmptyPage: 
# If page is out of range deliver last page of results 
posts = paginator.page (paginator.num pages) 
return render(request, 'blog/post/list.html', {'page': page, 
"DOSES™: Dots 
'tag': tag}) 


打开 blog 应 用 程序 的 urls.py 文件 ， 注 释 掉 基 于 类 的 PostListView URL 路 径 ， 并 对 
post list 视图 取消 注释 ， 如 下 所 示 : 


path('', views.post list, name='post list'), 
# path('', views.PostListView.as view(), name='post list'), 
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下 面 添加 额外 的 URL 路 径 ， 并 通过 标签 列 出 帖子 ， 如 下 所 示 : 


path('tag/<slug:tag slug>/', 


Views.post list, name='post list by tag'), 


不 难 发 现 ， 两 种 路 径 均 指向 了 同一 视图 ， 但 我 们 采用 了 不 同 的 方式 对 其 加 以 命 
其 中 ， 第 一 种 路 径 将 调用 post_list 视图 ， 且 不 包含 任何 可 选 参数 ， 而 第 二 种 路 径 将 利 
tag_slug 参数 调用 视图 。 此 处 采用 了 slug 路 径 转换 器 ， 并 以 包含 ASCII 字母 或 数字 、 连 
字符 、 下 面 线 的 小 写字 符 串 匹配 参数 。 

由 于 使 用 了 post_list 视图 ,因而 需要 编辑 blog/post/list.html 模板 ,并 调整 分 页 机 制 忆 
使 用 posts 对 象 ， 如 下 所 示 : 

{s include "pagination.html" with page=posts %} 

在 {% for %} 循 环 上 方 添加 下 列 代码 行 ， 如 下 所 示 : 


{% if tag %$} 
<h2>Posts tagged with "{{ tag.name }}"</h2> 
{% endif %} 


如 果 用 户 访问 当前 博客 ， 将 会 看 到 全 部 帖子 的 列表 。 如 果 通 过 包含 特定 标签 的 帖子 
对 其 进行 过 滤 ， 则 会 看 到 所 过 滤 用 的 对 应 标签 。 下 面 修改 标签 的 显示 方式 ， 如 下 所 示 : 
<p class="tags"> 
Tags: 
{% for tag in post.tags.all %} 
<a href="{% url "blog:post list by tag" tag.slug %}"> 
{{ tag.name }} 
</a> 
{% if not forloop.last %}, {% endif %} 
{% endfor %} 
</p> 


接 下 来 ， 对 于 显示 指向 URL 的 自 定义 链接 的 全 部 帖子 标签 ， 对 其 进行 遍历 并 根据 对 
应 的 标签 进行 过 滤 。 我 们 利用 {o% url "blog:post list by tag" tag.slug %} 构建 URL， 使 用 
URL 名 称 以 及 slug 标签 作为 其 参数 ， 并 使 用 逗号 分 隔 标签 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/blog/， 并 单 击 任意 标签 链接 。 图 2.13 显示 了 
该 标签 过 滤 的 帖子 列表 。 
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My Blog 


Posts tagged with "jazz" 


Who was Django Reinhardt? 


Tags: jazz , music 


Who was Django Reinhardt. 


Page 1 of 1. 


图 2.13 
2.4 根据 相似 性 检索 帖子 


前 述 内 容 实现 了 针对 博客 帖子 的 标签 机 制 ， 并 可 以 以 此 实现 诸多 有 趣 的 功能 。 根 据 
标签 机 制 ， 可 较 好 地 对 博客 帖子 进行 分 类 。 具 有 相似 话题 的 帖子 将 包含 多 个 公共 标签 
针对 于 此 ， 我 们 将 实现 一 项 功能 ， 并 通过 共有 的 标签 号 显示 相似 的 帖子 。 通 过 这 -方式 ， 
当 用 户 阅 读 某 个 帖子 时 ， 即 可 向 其 推荐 阅读 其 他 相关 帖子 。 

当 针 对 特定 帖子 检索 类 似 的 帖子 时 ， 需 要 执行 下 列 操作 步 又 : 

(1) 针对 当前 帖子 检索 全 部 标签 。 

(2) 获取 包含 特定 标签 的 全 部 帖子 。 

(3) ye i 以 避免 推荐 相同 的 帖子 。 

(4) 通过 当前 帖子 的 标签 号 ， 对 结果 进行 排序 。 

(5) 加 漆 肯 有 亲 同 村 类 号 的 商 中 不 个 梢 于， 推荐 使 用 最 近 发 布 的 帖子 。 

(6) 将 查询 限制 为 希望 推荐 的 帖子 数量 。 

上 述 各 项 步骤 可 转换 至 复杂 的 QuerySet 中 ， 并 将 其 置 入 post_detail 视图 中 。 对 此 ， 
打开 blog 应 用 程序 的 views.py 文件 ， 并 在 程序 开始 处 添加 下 列 导 入 语句 : 


from django.db.models import Count 
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这 表示 为 Django ORM 中 的 Count 聚合 (aggregation) 函数 ， 该 函数 可 执行 标签 的 汇 
总 计数 。 除 此 之 外 ，django.db .models 中 妹 创 从 了 下 列 聚 合 函数 : 

口 Avg 计算 平均 值 。 

口 Max 计算 最 大 值 。 

口 Min 计算 最 小 值 。 

口 Count 负责 对 象 计数 操作 。 

关于 聚合 函数 , 读者 可 访问 https://docs.djangoproject.com/en/2.0/topics/db/aggregation/ 
以 了 解 更 多 内 容 。 

在 render() 函 数 之 前 ， 在 post_detail 视图 中 添加 下 列 代码 行 : 

# List of similar posts 

post tags ids = post.tags.values list('id', flat=True) 

similar posts = Post.published.filter(tags in=post tags ids)\ 

-exclude (id=post .id) 


similar posts = similar posts.annotate (same tags=Count ('tags'))\ 
-order by('-same tags','-publish')[:4] 


上 述 代码 执行 下 列 操作 : 
(1) 针对 当前 帖子 的 标签 ， 检 索 Python ID 列表 。values_list() QuerySet 返回 包含 给 
定 字段 值 的 元 组 。 此 处 ， 可 将 flat=True 传递 至 其 中 ， 并 可 获得 形 如 [1, 2, 3, .…] 的 列表 
(2) 获取 包含 此 类 标签 的 全 部 帖子 ， 并 排除 当前 帖子 自身 。 
(3) 使 用 Count 聚合 函数 生成 一 个 计算 后 的 字段 ， 即 same_tags。 该 字段 包含 了 与 
所 有 查询 标签 所 共有 的 标签 号 。 
(4) 通过 共享 标签 号 对 结果 进行 排序 (降序 ) ; 对 于 包含 相同 标签 号 的 帖子 ， 将 显 
示 最 新 发 布 的 帖子 。 此 处 仅 检索 前 4 个 帖子 。 
对 于 render0 函 数 ， 向 上 下 文字 典 中 加 入 similar posts 对 象 ， 如 下 所 示 : 
return render (equest， 
'blog/post/detail.html', 
{BOSE Dost 
'comments': comments, 
'new comment': new comment, 


'comment form': comment form, 
'similar posts': similar posts}) 


随后 ， 编 辑 blog/post/detail.html 模板 ， 并 在 帖子 评论 列表 前 添加 下 列 代码 : 


<h2>Similar posts</h2> 
{s for post in similar posts %} 
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<p> 
<a href="{{ post.get absolute url }}">{{ post.title }}</a> 

</p> 

务 empty 要 } 

There are no similar posts yet. 

{$$ endfor %} 


图 2.14 显示 了 帖子 详细 页 面 内 容 。 


Who was Django Reinhardt? 


Who was Django Reinhardt. 


Share this post 


Similar posts 


图 2.14 
至 此 , 可 向 用 户 成 功 地 推荐 相似 的 帖子 ,另外 , django-taggit 还 包含 了 similar_objects() 
管理 器 ， 并 可 通过 共享 标签 检索 对 象 。 读 者 可 访问 https://djangotaggit.readthedocs.io/en/ 
latest/api.html， 以 查看 所 有 的 管理 器 。 
除 此 之 外 , 还 可 采用 与 blog/post/list.html 模板 相同 的 方式 , 向 帖子 详细 模板 中 添加 标 
签 列表 。 


2.5 本 章 小 结 


本 章 讨 论 了 与 Django 表单 和 模型 表单 间 的 协同 工作 方式 。 我 们 构建 了 一 个 系统 ， 
通过 邮件 方式 共享 站 点 内 容 ， 同 时 还 针对 博客 构建 了 评论 系统 。 其 中 ， 我 们 向 博客 帖子 
添加 了 标签 机 制 、 整 合 了 可 复 用 的 应 用 程序 ， 并 构建 了 复杂 的 QuerySet， 以 通过 相似 性 
检索 对 象 。 
第 3 章 将 考察 如 何 创建 自 定义 模板 标签 和 过 滤器 。 除 此 之 外 ， 还 将 构建 自 定义 网 站 
地 图 以 及 博客 帖子 的 输入 内 容 ， 并 实现 博客 帖子 的 全 文本 搜索 功能 。 


第 3 章 扩展 博客 应 用 程序 


第 2 章 讨论 了 表单 的 基础 知识 ， 并 学 习 了 如 何 将 第 三 方 应 用 程序 整合 至 项 目 中 。 本 
章 主要 涉及 以 下 内 容 : 
口 ”创建 自 定义 模板 标签 和 过 滤器 。 

口 ” 添 加 网 站 地 图 和 帖子 提要 。 
口 ”利用 PostgreSQL 实现 全 文本 搜索 。 


3.1 创建 自 定义 模板 标签 和 过 滤器 


Django 提供 了 不 同 的 内 建 模板 标签 ， 如 {% if %} 或 {% block %}， 前 述 内 容 也 曾 对 其 
加 以 使 用 。 关 于 内 建 模板 标签 和 过 滤器 的 完整 参考 , 读者 可 访问 https://docs.djangoproject. 
com/en/2.0/ref/templates/builtins/。 

然而 , Django 也 支持 创建 自己 的 目标 标签 , 并 执行 自 定义 操作 。 在 向 模板 添加 Django 
模板 标记 核心 集 未 涵盖 的 功能 时 ， 自 定义 模板 标签 非常 有 用 。 


3.1.1 创建 自 定义 模板 标签 


Django 提供 了 下 列 帮助 函数 ， 并 可 通过 较为 方便 的 方式 创建 自己 的 模板 标签 。 

口 ”simple tag 处 理 数据 并 返回 一 个 字符 串 。 

口 inclusion tag 处 理 数据 并 返回 所 显示 的 模板 。 

另外 ， 模 板 标签 须 位 于 Django 应 用 程序 中 。 

在 blog 应 用 程序 目录 中 , 创建 新 的 目录 并 将 其 命名 为 ttmplatetags， 同 时 添加 _init .py 
空 文件 。 随 后 ， 在 同一 个 文件 夹 中 创建 另 一 个 文件 ， 将 其 命名 为 blog_tags.py， 该 文件 的 
结果 如 下 所 示 : 

blog/ 

np 
models.py 


templatetags/ 
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init .py 
blog tags.py 
这 里 ， 文 件 的 命名 方式 十 分 重要 ， 我 们 将 使 用 该 模块 名 称 加 载 模板 中 的 标签 。 
下 面 开 始 创建 简单 的 标签 ， 并 检索 博客 中 发 布 的 所 有 帖子 。 对 此 ， 编 辑 刚刚 创建 的 
blog tags.py 文件 并 添加 下 列 代码 : 


from django import template 
from . .models import Post 


register = template.Library() 


@register.simple tag 
def total posts(): 
return Post.published.count () 

之 前 曾 创建 了 简单 的 模板 标签 ， 并 返回 所 发 布 的 帖子 数量 。 每 个 模板 标签 模块 都 需 
要 定义 一 个 register 变量 作为 有 效 的 标签 库 。 该 变量 表示 为 template.Library 实例 , 用 于 注 
册 自 己 的 模板 标签 和 过 滤器 。 随 后 ， 还 需要 通过 Python 函数 定义 一 个 名 为 total posts 的 
标签 ， 并 利用 @register.simple_tag 装饰 器 将 该 函数 注册 为 简单 的 标签 。Django 将 使 用 函 
数 名 作为 标签 名 称 。 如 果 需 要 通过 不 同 的 名 称 对 其 进行 注册 ， 则 可 设置 name 属性 ， 如 
人 @register.simple_ tag(name='my tag)。 


@@ 注意， 
在 添加 了 新 的 模板 标签 模块 后 ， 需 要 重新 启动 Django 开发 服务 器 ， 以 使 用 模板 中 
的 新 的 标签 和 过 滤器 


在 使 用 自 定义 模板 标签 之 前 ， 须 通过 {% load %} 标 签 使 其 对 模板 生效 。 如 前 所 述 ， 
此 处 需要 采用 包含 模板 标签 和 过 滤器 的 Python 模块 名 称 。 对 此 ， 打 开 blog/templates/ 
base.html 模板 ， 并 在 开始 处 添加 {% load blog tags %}， 以 加 载 模板 标签 模块 。 随 后 ， 可 
使 用 创建 的 标签 显示 全 部 帖子 一 一 仅 需 向 模板 中 添加 {%total_posts %} 即 可 。 对 应 的 模板 
如 下 所 示 : 

{% load blog tags %} 

{% 1oad static %} 

<!DOCTYPE html> 

<html> 


<head> 
<title>{% block title %}{% endblock %}</title> 
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<link href="{% static "css/blog.css" $}" rel="stylesheet"> 
</head> 
<body> 
<div id="content"> 
{% block content %} 
{% endblock $} 
</div> 
<div id="sidebar"> 
<h2>My blog</h2> 
<p>This is my blog. I've written {% total posts %} posts so far.</p> 
</div> 
</body> 
</html> 


接 下 来 需要 重新 启动 服务 器 ,并 跟踪 添加 至 项 目 中 的 新 文件 。 相应 地 , 可 利用 Ctrl+C 
快捷 键 终止 开发 服务 器 ， 并 使 用 下 列 命令 再 次 运行 服务 器 ， 如 下 所 示 : 
Python manage.py runserver 


在 浏览 器 中 打开 http://127.0.0.1:8000/blog/， 将 会 显示 所 有 的 帖子 数量 ， 如 图 3.1 所 示 。 


My blog 


This is my blog. lve written 4 posts so far. 


图 3.1 
自 定义 模板 标签 的 功能 可 描述 为 :， 可 处 理 任意 数据 并 将 其 添加 至 模板 中 ， 且 无 须 考 
We 的 视图 。 我们 可 以 执行 QuerySet 或 处 理 任 意 数据 ， 以 在 模板 中 显示 最 终 的 结果 。 
下 面 生成 另 一 个 标签 ， 并 在 博客 的 侧 栏 中 显示 最 新 的 帖子 。 这 里 将 使 用 到 包含 标签 ， 
据 此 ， 可 利用 模板 标签 返回 的 上 下 文 变量 显示 一 个 模板 。 编 辑 blog tags.py 文件 并 添加 下 
列 代码 : 


@register.inclusion tag('blog/post/latest posts.html') 

def show latest posts (Count=5) : 
latest posts = Post.published.order by('-publish')[:count] 
return {'latest posts': latest posts} 


在 上 述 代 码 中 , 通过 @register.inclusion_tag 注册 模板 标签 , 并 指定 利用 返回 值 显示 的 
模板 (通过 blog/posUlatest_posts.html) 。 当 前 模板 标签 接收 一 个 可 选 参数 count， 该 参数 
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的 默认 值 为 5， 进 而 定义 需要 显示 的 帖子 数量 。 此 处 ,我 们 使 用 该 变量 来 限制 Postpublished. 
order by(-publish)[:count] 的 查询 结果 。 需 要 注意 的 是 ， 该 函数 返回 一 个 变量 字典 ， 而 非 
一 个 简单 值 。 包 含 标签 需要 返回 一 个 数值 字典 ， 用 作 当 前 上 下 文 并 显示 特定 的 模板 。 刚 
刚 生 成 的 模板 标签 可 指定 帖子 的 数量 ， 并 作为 {% show_latest posts 3 %} 予 以 显示 。 
下 面 在 blog/post/ 下 创建 新 的 模板 文件 ， 将 其 命名 为 latest_posts.html 并 添加 下 列 
代码 : 
<ul> 
{% for post in latest posts %} 
<1i> 
<a href="{{ post.get absolute url }}">{{ post.title }}</a> 
</1i> 
{ endfor %} 
</ul> 
上 述 代码 使 用 模板 标签 返回 的 latest_posts 显示 无 序 帖 子 列表 。 下 面 ， 编 辑 blog/ 
base.html 模板 并 添加 新 的 模板 标签 ， 以 显示 最 新 的 3 个 帖子 。 相 应 地 ， 侧 栏 代码 如 下 
所 示 : 
<div id="sidebar"> 


<h2>My blog</h2> 
<p>This is my blog. I've written {% total posts %} posts so far.</p> 


<h3>Latest posts</h3> 

{% show latest posts 3 %} 
</div> 
通过 传递 所 显示 的 帖子 数量 ， 模 板 将 被 调用 并 根据 现 有 上 下 文 予以 显示 。 
下 面 返回 至 浏览 器 中 并 刷新 当前 页 面 ， 此 时 ， 侧 栏 内 容 如 图 3.2 所 示 。 


My blog 


This is my blog. lve written 4 posts so far. 


Latest posts 
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最 后 还 将 生成 一 个 简单 的 模板 标签 ， 并 在 变量 中 存储 当前 结果 ， 以 供 后 续 操作 复 用 ， 
而 非 直接 对 其 予以 输出 。 除 此 之 外 ， 还 需 创建 一 个 标签 以 显示 最 近 评 论 的 帖子 。 对 
编辑 blog tags.py 文件 ， 并 于 其 中 添加 下 列 导入 语句 以 及 模板 标签 : 


from django.db.models import Count 


L, 


@register.simple tag 
def get most commented posts (Count=5) : 
return Post.published.annotate( 
total comments=Count('comments') 
) .order by('-total comments')[:count] 


在 上 述 目 标 标签 中 ， 我 们 通过 annotate0 函 数 构建 了 QuerySet， 并 针对 每 个 帖子 汇总 
了 全 部 评论 数量 。 其 中 使 用 了 Count 聚合 函数 ， 针 对 每 个 Post 对 象 将 评论 数量 存储 于 
total _ comments 字段 中 ， 并 通过 计算 后 的 字段 以 降序 对 QuerySet 进行 排序 。 除 此 之 外 ， 
还 提供 了 一 个 可 选 的 counr 变量 ， 以 限制 所 返回 的 全 部 对 象 数量 。 
除了 Count 之 外 ，Django 还 提供 了 聚合 函数 Avg、Max、Min 以 及 Sum。 关 于 聚合 
函数 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/db/aggregation/ 以 了 解 更 多 
内 容 。 
编辑 blog/base.html 模板 ， 并 向 侧 栏 <div> 元 素 中 添加 下 列 代码 : 
<h3>Most commented posts</h3> 
{s get most commented posts as most commented posts %} 
<ul> 
{% for post in most commented posts %} 
<1i> 
<a href="{{ post.get absolute url }}">{{ post.title }}</a> 
</1i> 
{%% endfor $} 
</ul> 


通过 变量 名 后 的 as 参数 ， 可 将 当前 结果 存储 于 自 定义 变量 中 。 对 于 当前 模板 标签 ， 
我 们 使 用 {% get_ most_ commented_ posts as most_commented_ posts %} 将 模板 标签 结果 存 
储 于 新 变量 most_commented posts 中 。 随 后 ， 可 通过 无 序列 表 显 示 返 回 后 的 帖子 。 

打开 浏览 器 并 刷新 当前 页 面 以 查看 最 终结 果 ， 如 图 3.3 所 示 。 

前 述 内 容 讲述 了 自 定 义 模板 标签 的 构建 方式 。 此 外 ， 读 者 还 可 访问 https://docs. 
djangoproject.com/en/2.0/howto/custom-template-tags/ 以 了 解 更 多 内 容 。 
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127.00.4:8000/blog/ 


My blog 


This is my blog. ve writen 4 posts so far 


Latest posts 


Most commented posts 
oNM 


Edward Kennedy "Duke" Ellington was an American composer, pianist, and bandleader of a jazz 
orchestra. 


Post body. 


图 33 
3.1.2 创建 自 定义 模板 过 滤器 


Django 包含 了 各 种 内 建 模板 过 滤器 ， 并 可 调整 模板 中 的 变量 。 此 类 过 滤器 表示 为 

Python 函数 ， 且 接收 一 个 或 多 个 参数 ， 即 所 用 的 变量 值 以 及 可 选 参数 。 随 后 ， 函 数 返 回 
-个 值 并 可 通过 另 一 个 过 滤器 予以 显示 或 处 理 。 具 体 来 说 ， 过 滤器 形 如 {{ variablelmy_ 

filter }}; 包含 参数 的 过 滤器 则 表示 为 {{ variablelmy_filter:"foo" }}。 另 外 ， 还 可 针对 某 个 
变量 使 用 任意 多 个 过 滤器 ， 如 {{ variablelfilterllfilter2 }}， 且 每 一 个 过 滤器 可 用 于 上 一 个 
过 滤器 所 生成 的 结果 。 

下 面 将 创建 一 个 自 定 义 过 滤器 ， 在 博客 帖子 中 使 用 Markdown 语法 ， 并 于 随后 将 帖 
子 内 容 转换 为 模板 中 的 HTML。Markdown 表示 为 一 类 纯 文 本 语法 格式 且 易 于 使 用 , 旨 在 
转换 为 HTML。 读 者 可 访问 https://daringfireball.net/projects/markdown/basics 以 了 解 其 基 
础 内 容 。 

首先 通过 下 列 命令 以 及 pip 安装 Python Markdown 模块 。 

pip install Markdown==2.6.11 


接 下 来 ， 编 辑 blog_tags.py 文件 并 添加 下 列 代码 : 


from django.utils.safestring import mark safe 
import markdown 
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@register.filter (name='markdown') 
def markdown format (text) : 
return mark safe (markdqown -markdown (text)) 


我 们 采用 了 与 模板 标签 相同 的 方式 注册 了 过 滤器 。 为 了 避免 函数 名 与 Markdown 模 
块 间 产 生 冲 突 ， 可 将 函数 命名 为 markdown_format， 同 时 将 过 滤器 命名 为 markdown 以 供 
模板 使 用 ， 如 {{ variablelmarkdown }}。Django 转 义 了 过 滤器 生成 的 HTML 代码 。 我 们 使 
Django 提供 的 mark_safe 函数 将 当前 结果 标记 为 安全 的 HIML, 并 在 模板 中 加 以 显示 。 
默认 状态 下 ，Django 并 不 信任 任何 HIML 代码 ， 并 在 将 其 置 于 输出 之 前 进行 转 义 。 唯 一 
的 情况 是 转 义 过 程 中 标记 为 安全 的 变量 ， 这 种 行为 可 防止 Django 输出 危险 的 HIML， 并 
可 为 返回 安全 的 HTML 创建 异常 

下 面 加 载 帖 子 列表 和 模板 中 的 模板 标签 ， 并 在 blog/post/list.html 和 blog/post/ 
detail.html 模板 开始 处 以 及 {% extends %} 标 签 之 后 添加 下 列 代码 : 


{% load blog tags %} 


在 post/detail.html 模板 中 ， 考 察 下 列 代码 行 : 

{{ post.bodyllinebreaks }} 

并 利用 下 列 代码 对 其 进行 蔡 换 : 

{{ post.body|lmarkdown }} 

接 下 来 ， 在 post/list.html 文件 中 ， 蔡 换 下 列 代码 行 : 

{{ post.bodyltruncatewords:30|linebreaks }} 

并 改写 为 下 列 代码 : 

{{ post.bodylmarkdown|truncatewords html:30 }} 

truncatewords_html 过 滤器 将 在 一 定数 量 的 单词 后 剪裁 一 个 字符 串 ， 以 防止 出 现 未 闭 
合 的 HIML 标签 

下 面 在 浏 览 器 中 打开 http://127.0.0.1:8000/admin/blog/post/add/， 并 添加 下 列 帖子 主体 
内 容 : 


This is a post formatted with markdown 


*This is emphasized* and **this is more emphasized**. 
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Here is a list: 
* One 


* 了 WO 
* Three 


And a [link to the Django website] (https://www.djangoproject.com/) 


打开 浏览 器 并 查看 帖子 的 显示 方式 ， 如 图 3.4 所 示 。 


Markdown post 


This is a post formatted with markdown 
This is emphasized and this is more emphasized. 
Here is a list: 

。 One 

。 Two 

。 Three 


And a link to the Django website 


图 3.4 


不 难 发 现 ， 对 于 定制 格式 来 说 ， 自 定义 模板 过 滤器 十 分 有 用 。 关 于 


- 自 定 义 过 滤器 ， 


读者 可 访问 https://docs.djangoproject.com/en/2.0/howto/custom-template-tags/#writing-custom- 


template-filters 以 了 解 更 多 内 容 。 


3.2 ”向 站 点 添加 网 站 地 图 


Django 中 包含 了 网 站 地 图 框架 ， 进 而 可 动态 地 生成 网 站 地 图 。 这 里 网 站 地 图 是 一 个 
XML 文件 ， 可 将 网 站 页 面 、 相 关 性 以 及 更 新 频率 通知 与 搜索 引擎 。 当 采用 网 站 地 图 时 ， 


可 实现 网 站 内 容 的 索引 化 。 
Django 网 站 地 图 框架 依赖 于 django.contrib.sites， 并 可 将 对 象 关 联 了 
网 站 上 。 当 通过 单一 Django 项 目 运行 多 个 站 点 时 ， 这 将 变 得 十 分 方便 。 
框架 时 ， 需 要 在 当前 项 目 中 激活 站 点 和 网 站 地 图 应 用 程序 。 对 此 ， 编 辑 


F 项 目 运行 的 特定 
当 安装 网 站 地 图 
项 目的 settings.py 


文件 , 并 向 INSTALLED_APPS 设置 中 添加 django.contrib.sites 和 django.contrib.sitemaps， 
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进而 针对 站 点 D 定义 新 的 设置 内 容 ， 如 下 所 示 : 


STITESTD = 1 


# Application definition 
INSTALLED APPS = [ 

:We 

"django .contrib.sites'， 

"django .contrib.sitemaps'， 
] 


运行 下 列 命令 ， 并 在 数据 库 中 创建 Django 站 点 应 用 程序 表 : 
Python manage.py migrate 
对 应 输出 结果 包含 下 列 内 容 : 


Applying sites.0001 initial... OK 
Applying sites.0002 alter domain unique... OK 
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sites 应 用 程序 将 与 数据 库 同步 。 下 面 在 blog 应 用 程序 目录 中 创建 新 的 文件 ， 并 将 其 


命名 为 sitemaps.py。 打 开 该 文件 并 向 其 中 添加 下 列 代码 : 


from django.contrib.sitemaps import Sitemap 
from .models import Post 


class PostSitemap (Sitemap): 
changefreq = 'weekly' 
priority = 0.9 


def items (self): 
return Post.published.all() 


def lastmod(self, obj): 
return obj.updated 


通过 继承 sitemaps 模块 的 Sitemap 类 , 可 生成 自 定义 网 站 地 图 。changefreq 和 priority 


比 网 站 地 图 中 的 对 象 的 QuerySet。 默 认 状态 下 ，Django 在 每 个 对 象 上 调 


属性 表示 帖子 页 面 及 其 站 点 内 相关 性 的 变化 频率 (最 大 值 为 1) 。items0) 方 法 返回 包含 在 


] get_absolute urlO 


方法 并 检索 其 URL。 回 忆 一 下 ,第 1 章 中 曾 定义 了 该 方法 ， 以 检索 帖子 的 标准 URL。 如 


果 需 要 针对 每 个 对 象 指定 URL， 可 向 网 站 地 图 类 中 添加 location 方法 。 


lastmod 方法 检索 


items() 返 回 的 各 个 对 象 ， 并 返回 对 象 最 近 一 次 被 修改 的 时 间 。 另 外 ，changefreq 和 priority 
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方法 可 定义 为 方法 或 属性 。 关 于 完整 的 网 站 地 图 参考 ， 读 者 可 查看 Django 官方 文档 ， 对 
应 网 址 为 https://docs.djangoproject.com/en/2.0/ref/contrib/sitemaps/。 

最 后 一 个 步骤 仅 需 添加 网 站 地 图 URL。 对 此 ， 编 辑 项 目的 urls.py 主 文件 并 添加 网 站 
， 如 下 所 示 : 


from django.urls import path, include 


地 


而 


from django.contrib import admin 
from django.contrib.sitemaps.views import sitemap 
from blog.sitemaps import PostSitemap 


sitemaps = { 
'posts': Postsitemap, 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('blog/', include('blog.urls', namespace='bl0og')), 
path('sitemap.xml', sitemap, {'sitemaps': sitemaps}, 
name='django.contrib.sitemaps.views.sitemap') 

] 

上 述 代码 包含 了 所 需 的 导入 语句 ， 并 定义 了 网 站 地 图 字典 。 我 们 定义 了 一 个 与 
sitemap.xml 匹配 的 URL 路 径 ， 并 使 用 了 站 点 地 图 视图 。sitemaps 目录 被 传递 至 sitemap 
视图 中 。 下 面 运行 开 发 服务 器 并 在 浏览 器 中 打开 http://127.0.0.1:8000/sitemap.xml。 我 们 
将 会 看 到 下 列 XML 输出 结果 : 

<?xml Version="1.0" encoding="utf-8"?> 

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> 

<url> 
<loc>http://example.com/blog/2017/12/15/markdown-post/</loc> 
<lastmod>2017-12-15</lastmod> 
<changefreq>weekly</changefreq> 
<priority>0.9</priority> 
</url> 
<url> 
<loc> 
http://example.com/blog/2017/12/14/who-was-django-reinhardt/ 
</loc> 
<lastmod>2017-12-14</lastmod> 
<changefreq>weekly</changefreq> 
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<priority>0.9</priority> 
ht 
</urlset> 


每 个 帖子 的 URL 通过 调用 其 get_absolute_url0 方 法 被 构建 -Lastmod 属性 对 应 于 帖子 


的 updated 字段 一 一 这 在 网 站 地 图 中 己 被 指定 ; changefreq 和 priority 属性 也 源 
PostSitemap 类 。 我 们 同时 还 会 看 到 ， 用 于 设置 URL 的 域名 表示 为 example.com。 相 


自 


应 


地 ， 该 域名 源 自 存储 于 数据 库 中 的 Site 对 象 。 当 站 点 框架 与 数据 库 同步 时 ， 这 一 默认 对 
象 即 被 创建 。 在 浏览 器 中 打开 http://127.0.0.1:8000/admin/sites/site/， 对 应 结果 如 图 3.5 


所 示 。 


Django administration WELCOME, ADMIN. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Home» Sites; Sites 


Select site to change 


DOMAIN NAME < DISPLAY NAME 
了 example.com example com 


1 site 


图 3.5 
如 图 3.5 所 示 为 包含 了 站 点 框架 的 列表 显示 管理 视图 。 此 处 , 可 设置 站 点 框架 所 
域名 或 主机 ， 以 及 基于 此 的 应 用 程序 。 为 了 生成 位 于 本 地 环境 中 的 URL， 可 将 域名 修 
为 localhost:8000 并 保存 ， 如 图 3.6 所 示 。 


Change site 


Domain name: localhost:8000 


Display name: localhost:8000 


的 


改 
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如 图 3.6 所 示 的 URL 通过 该 主机 名 构造 。 在 产品 环境 中 ， 则 需要 针对 站 点 的 框架 使 
自己 的 域名 。 


3.3 创建 帖子 提要 


Django 包含 了 一 个 内 建 聚合 提要 〈feed) 框架 ， 类 似 于 采用 站 点 框架 生成 网 站 地 图 ， 
| 据 此 动态 生成 RSS 或 Atom 提要 。Web 提要 是 一 种 数据 格式 (通常 为 XML) ， 并 可 向 
户 提 供 频 繁 更 新 的 内 容 。 用 户 可 以 使 用 提要 聚合 器 订阅 提要 ， 这 是 一 种 用 于 读 取 提 要 
和 获取 新 内 容 通 知 的 软件 。 
在 blog 应 用 程序 目录 中 创建 新 文件 ， 将 其 命名 为 feeds.py 并 添加 下 列 代 码 行 : 
from django.contrib.syndication.views import Feed 


from django.template.defaultfilters import truncatewords 
from .models import Post 


-| 


class LatestPostsFeed (Feed) : 
title = 'My blog' 
link = '/blog/' 
description = 'New posts of my blog."' 


def items (self): 
return Post.published.all()[:5] 


def item title(self, item): 
return item.title 


def item description(self, item): 

return truncatewords (item.body, 30) 
代码 首先 定义 了 聚合 框架 中 Feed 类 的 子 类 。 title、link 以 及 description 属性 分 别 对 应 

于 <title>、<link> 和 <description> RSS 元 素 。 
items() 方 法 用 于 检索 包含 于 提要 中 的 对 象 。 针 对 当前 提要 , 我 们 仅 检 索 最 后 5 个 发 布 
的 帖子 。item title0 和 item_description() 方 法 获取 items0 返 回 的 每 个 对 象 ， 并 返回 每 个 条 
目的 标题 和 描述 内 容 。 此 外 ， 我 们 使 用 truncatewords 内 建 模板 过 滤器 构建 博客 帖子 的 描 
述 内容 (利用 前 30 个 单词 ) 。 
下 面 编 辑 blog/urls.py 文件 ， 导 入 刚刚 创建 的 LatestPostsFeed， 并 在 新 的 URL 路 径 中 
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实例 化 提要 内 容 ， 如 下 所 示 : 


from .feeds import LatestPostsFeed 


urlpatterns = [ 

i 二 
path('feed/', LatestPostsFeed(), name='post feed'), 
] 


。7T3。 


在 浏览 器 中 访问 http://127.0.0.1:8000/blog/feed/， 将 会 看 到 RSS 提要 内 容 ， 其 中 包含 


了 最 近 的 5 个 博客 帖子 ， 如 下 所 示 : 
<?xml Version="1.0" encoding="utf-8"?> 
<rss xmlns:atom="http://www.w3.o0rg/2005/Atom" version="2.0"> 
<channel> 
<title>My blog</title> 
<link>http://localhost:8000/blog/</1link> 
<description>New posts of my blog.</description> 


<atom:link href="http://localhost:8000/blog/feed/" rel="self"/> 


<language>en-us</language> 


<lastBuildDate>Fri, 15 Dec 2017 09:56:40 +0000</lastBuildDate> 


<item> 
<title>Wwho was Django Reinhardt?</title> 
<link>http://localhost:8000/blog/2017/12/14/who-was— 
djangoreinhardt/</link> 
<description>Who was Django Reinhardt.</description> 
<guid>http://localhost:8000/blog/2017/12/14/who-was-— 
djangoreinhardt/</guid> 

</item> 


</channel> 
</rss> 


如 果 在 RSS 客户 端 打开 相同 的 RSS， 将 会 看 到 包含 用 户 友好 界面 的 提要 内 容 。 


最 后 一 步 是 添加 指向 博客 侧 栏 的 提要 订阅 链接 。 打 开 blog/base.html 模板 并 添加 下 列 


代码 行 〈 在 侧 栏 div 内 ， 全 部 帖子 数量 下 方 ) : 


<p><a href="{% url "blog:post feed" %$}">Subscribe to my RSS feed</a></p> 


在 浏览 器 中 打开 http://127.0.0.1:8000/blog/ 并 查看 侧 栏 。 新 生成 的 链接 将 指向 博客 的 


提要 内 容 ， 如 图 3.7 所 示 。 
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My blog 


This is my blog. I've written 5 posts so far. 


Subscribe to my RSS feed 


图 3.7 
3.4 向 博客 中 添加 全 文本 搜索 功能 


本 节 将 向 博客 中 添加 搜索 功能 。Django ORM 可 通过 contains 过 滤器 (或 者 其 小 写 版 本 
icontains) 执行 简单 的 匹配 操作 。 我 们 可 采用 下 列 查询 获得 包含 单词 famework 的 帖子 : 

from blog.models import Post 

Post.objects.filter(body contains='framework') 

然而 ， 如 果 希 望 执 行 复杂 的 查询 操作 ， 根 据 相似 性 或 权重 检索 结果 ， 则 需要 使 用 全 
文本 搜索 引擎 。 

Django 提供 了 构建 于 PostgreSQL 全 文本 搜索 之 上 的 、 功 能 强大 的 搜索 功能 。 其 中 ， 
django.contrib.postgres 模块 涵盖 了 PostgreSQL 所 提供 的 这 一 功能 ， 且 不 会 被 Django 所 支 
持 的 其 他 数据 库 所 共享 。 关 于 PostgreSQL 全 文本 搜索 ， 读 者 可 访问 https://www.postgresql. 
org/docs/10/static/textsearch. html 以 了 解 更 多 内 容 。 


© i. 
虽然 Django 是 一 类 独立 于 数据 库 的 Web 框架 ， 但 仍 提供 了 一 个 模块 ， 并 可 支持 
PostgreSQL 中 的 部 分 功能 集 ， 但 不 会 被 Django 所 支持 的 其 他 数据 库 所 共享 。 


3.4.1 安装 PostgreSQL 


发 


前 ，blog 项 目 中 使 用 了 SQLite 数据 库 ， 对 于 当前 的 开发 目标 来 说 这 已 然 足够 。 但 
是 ， 对 于 产品 环境 来 说 ， 还 需要 使 用 到 诸如 PostgreSQL、MySQL 或 Oracle 这 一 类 功能 更 
加 强大 的 数据 库 。 对 此 ， 我 们 将 使 用 PostgreSQL 并 受益 于 其 全 文本 搜索 功能 。 

对 于 Linux 环境 ， 可 通过 下 列 方式 安装 PostgreSQL 依赖 关系 ， 进 而 与 Python 协同 
工作 5 


sudo apt-get install libpq-dev Python-dev 
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接 下 来 ， 可 利用 下 列 命令 安装 PostgreSQL: 


sudo apt-get install Postgresql postgresql-contrib 


对 于 macOS X 或 Windows 环境 ， 可 访问 https://www.postgresql.org/download/ 下 载 并 
安装 PostgreSQL 。 

除 此 之 外 ， 还 需 针 对 Python 安装 Psycopg2 PostgreSQL 适配器 。 对 此 ， 可 在 Shell 中 
运行 下 列 命令 进行 安装 : 

Pip install psycopg2==2.7.4 

下 面 针 对 PostgreSQL 数据 库 创建 一 个 用 户 。 对 此 ， 打 开 Shell 并 运行 下 列 命 令 : 

su postgres 

createuser -dP blog 

新 用 户 将 会 被 提示 输入 密码 。 输 入 密码 后 将 创建 blog 数据 库 ， 并 利用 下 列 命令 生成 
基于 blog 用 户 的 隶属 关系 : 

Createdb -E utf8 -U blog blog 

随后 ， 编 辑 项 目的 settings.py 文件 并 调整 DATABASES 设置 内 容 ， 如 下 所 示 : 


DATABASES = { 
vets Eault 4 
'ENGINE': "django.db.backends .postgresql' 
'NAME': 'blog'， 
”USER7 “Blogs 
"PASSNORDY WA 


} 

利用 数据 库 名 称 和 用 户 凭据 蔡 换 上 述 数据 ， 新 的 数据 库 随后 呈现 为 空 状态 。 运 行 下 
列 命 令 并 应 用 全 部 数据 库 迁 移 : 

Python manage.py migrate 

最 后 ， 利 用 下 列 命 令 创 建 超级 用 户 : 

Python manage.py createsuperuser 

随后 运行 开发 服务 器 , 并 利用 超级 用 户 身份 访问 http://127.0.0.1:8000/admin/ 处 的 管理 
站 点 。 

由 于 在 数据 库 间 进行 切换 ， 因 而 并 无 帖子 存储 于 其 中 。 对 此 ， 可 利用 一 组 博客 示例 
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帖子 填充 新 数据 库 ， 以 对 其 执行 搜索 操作 。 
3.4.2 简单 的 查询 操作 


编辑 项 目的 settings.py 文件 ， 并 向 INSTALLED_ APPS 设置 中 添加 django.contrib. 
postgres， 如 下 所 示 : 
INSTALLED APPS = [ 
a 
"django .contrib.postgres', 
] 
下 面 利用 search QuerySet 查询 功能 针对 单一 字段 进行 搜索 ， 如 下 所 示 : 


from blog.models import Post 
Post.objects.filter(body search='django') 


该 查询 采用 PostgreSQL 针对 body 字段 创建 一 个 搜索 向 量 ， 并 从 django 中 创建 一 个 
搜索 查询 。 最 终结 果 可 通过 该 查询 与 向 量 间 的 匹配 而 得 到 。 


3.4.3 ”多 字段 搜索 


某 些 时 候 ， 我 们 可 能 需要 对 多 个 字段 进行 搜索 。 此 时 ， 需 要 定义 SearchVector。 下 面 
将 设置 一 个 向 量 ， 并 对 Post 模型 的 title 和 body 字段 进行 搜索 ， 如 下 所 示 : 


from django .contrib.postgres.search import SearchVector 
from blog.models import Post 


Post.objects.annotate( 

search=SearchVector ('title'，'body')， 

) .filter (search='django') 

通过 注释 并 针对 两 个 字段 定义 SearchVector, 我 们 提供 了 一 个 功能 , 可 以 将 查询 与 帖 
子 的 标题 和 正文 进行 匹配 。 

@ +i. 

全 文本 搜索 是 一 类 密集 型 处 理 过 程 。 如 果 对 数 百 行 数据 进行 搜索 ， 则 应 定义 一 个 函 
数 索 引 ， 并 匹配 所 用 的 搜索 向 量 。Dijango 针对 模型 提供 了 SearchVectorField 字段 ， 读 者 
可 访问 https://docs.djangoproject.com/en/2.0/ref/contrib/postgres/search/#performance 以 了 解 
更 多 内 容 。 
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3.4.4 构建 搜索 视图 


本 节 将 构建 一 个 自 定义 视图 ， 以 供用 户 搜索 帖子 使 用 。 首 先 ， 我 们 需要 对 表单 进行 
搜索 。 对 此 ， 编 辑 blog 项 目的 forms.py 文件 ， 并 添加 下 列表 单 : 


class SearchForm (forms .Form) : 
query = forms .CharField() 


此 处 将 使 用 query 字段 ， 以 使 用 户 产生 查询 项 。 编 辑 blog 应 用 程序 的 views.py 文件 ， 
并 向 其 中 添加 下 列 代码 : 

from django.contrib.postgres.search import SearchVector 

from .forms import EmailPostForm, CommentForm, SearchForm 


def post search(request): 
form = SearchForm() 
query = None 
results = [] 
if 'query' in request.GET: 
form = SearchForm(request .GET) 
if form.is valid(): 
query = form.cleaned data[l'query'] 
results = Post.objects .annotate( 
search=SearchVector('title', 'body'), 
) .filter(search=query) 
return render(request, 
'blog/post/search.html', 
{'form': form, 
'query': query, 
‘'results': results}) 


在 上 述 视图 中 ， 首 先 将 实例 化 SearchForm 表单 ， 并 打算 利用 GET 方法 提交 该 表单 ， 
以 使 最 终 的 URL 包含 query 参数 。 当 检测 表单 是 否 被 成 功 提交 时 ， 将 在 request.GET 字 
典 中 查询 query 参数 。 若 表单 被 提交 ， 则 利用 提交 后 的 GET 数据 对 其 进行 实例 化 ， 并 验 
证 表单 数据 是 否 有 效 。 若 是 ， 则 利用 自 定义 的 SearchVector 实例 (通过 title 和 body 字段 
构建 搜索 帖子 。 
当前 ， 搜 索 视 图 已 准备 就 绪 。 我 们 需要 创建 一 个 模板 ， 并 在 用 户 执 行 搜索 时 显示 表 
单 和 对 应 结果 。 对 此 ， 可 在 /blog/post/ 模 板 目 录 中 创建 新 的 文件 ， 将 其 命名 为 search.html 
添加 下 列 代码 : 
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{s extends "blog/base.html"™" %} 


{$$ block title $}Search{% endblock %} 


{% block content %} 
{% if query %} 
<hl>Posts containing "{{ query }}"</hl> 
<h3> 
{$$ with results.count as total results $} 


Found {{ total results }} result{{ total results|lpluralize }} 
{$$ endwith %} 


</h3> 
{% for post in results %} 
<h4><a href="{{ post.get absolute Url }}">{{ post.title }}</a></h4> 


{{ post.bodyltruncatewords:5 }} 
{$$ empty %} 
<p>There are no results for your query.</p> 
{ endfor %} 


<p><a href="{% Url "blog:post search" $%}">Search again</a></p> 
{$% else %} 
<hl>Search for posts</hl> 
<form action="." method="get"> 
tt form-as p. }} 
<input type="submit" value="Search"> 
</form> 
{g% endif %} 
{%% endblock %} 


与 搜索 视图 一 样 ， 我 们 可 以 通过 查询 参数 的 存在 来 区 分 表单 是 否 已 经 提交 。 在 帖子 
被 提交 之 前 ， 需 要 显示 当前 表单 和 提交 按钮 。 在 贴 子 被 提交 之 后 ， 可 显示 所 执行 的 查询 
结果 、 全 部 结果 数量 以 及 所 返回 的 帖子 列表 。 


最 后 ， 编 辑 blog 应 用 程序 的 urls.py 文件 ， 并 加 入 下 列 URL 路 径 : 


path('search/', views.post search, name='post search') 


在 浏览 器 中 打开 http://127.0.0.1:8000/blog/search， 对 应 结果 如 图 3.8 所 示 。 


Search for posts 


Query: 


图 3.8 
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输入 某 项 查询 并 单 击 SEARCH 按钮 ， 对 应 查询 的 搜索 结果 如 图 3.9 所 示 。 


Posts containing "music My blog 


This is my blog. Ive written 4 
Found 2 results rs 


Post body. Latest posts 


The Django web framework was … 
Most commented posts 


图 3.9 
截至 目前 ， 对 于 当前 博客 ， 我 们 已 经 构建 了 基本 的 搜索 引擎 。 


3.4.5 ”对 结果 提取 和 排名 


Django 定义 了 SearchQuery 类 ， 并 将 数据 项 转换 为 搜索 查询 对 象 。 默 认 状 态 下 ， 数 
据 项 通过 词 干 提取 〈stemming) 算法 被 传递 ， 从 而 可 获得 较 好 的 匹配 结果 。 另 外 ， 还 可 
能 根据 相关 性 进行 排序 ，PostgreSQL 提供 了 一 个 排名 函数 ， 并 根据 查询 项 的 出 现 频 率 以 
及 接近 程度 对 结果 进行 排序 。 对 此 ， 编 辑 blog 应 用 程序 中 的 views.py 文件 ， 并 加 入 下 列 
导入 语句 : 

from django.contrib.postgres.search import SearchVector, SearchQuery, 

SearchRank 


接 下 来 考察 下 列 代 码 行 : 


results = Post.objects.annotatel( 
search=SearchVector('title', 'body'), 
) .filter (search=query) 


并 利用 下 列 代码 行进 行 蔡 换 : 


search Vector = SearchVector('title', 'body') 

search query = SearchQuery (query) 

results = Post.objects.annotatel 
search=search vector, 
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rank=SearchRank (search vector, search query) 
) .filter (search=search query) .order by('-rank') 
上 述 代 码 定义 了 SearchQuery 对 象 ， 并 以 此 对 结果 进行 过 滤 ， 同 时 使 用 SearchRank 
并 根据 相关 性 对 结果 进行 排序 。 在 浏览 器 中 打开 http:/127.0.0.1:8000/blog/search/， 并 对 不 
同 的 搜索 进行 测试 ， 进 而 测试 词 干 提取 和 排名 操作 。 图 3.10 显示 了 帖子 标题 和 主体 内 容 
中 ， 单 词 django 出 现 次 数 的 排名 结果 。 


Posts containing "django" 


Found 3 results 

Django, Django, Django 
Django is the Web Framework ... 
Django twice 

Django offers full text search ... 
Django once 


A Python web framework. 


again 


图 3.10 


3.4.6 ”加 权 查 询 


我 们 可 以 增加 特定 的 向 量 ， 这 样 在 根据 相关 性 排序 结果 时 ， 就 可 以 赋予 它们 更 多 的 
权重 。 例 如 ， 可 据 此 向 标题 匹配 (而 非 内 容 匹 配 〉 的 帖子 提供 更 多 的 相关 性 。 针 对 于 此 ， 
可 编辑 blog 应 用 程序 中 的 views.py 文件 ， 如 下 所 示 : 

search vector = SearchVector('title', weight='A') + SearchVector('body', 

weight='B') 

search query = SearchQuery (query) 

results = Post.objects.annotate( 

rank=SearchRank (search vector, search query) 

) .filter(rank gte=0.3) .order by('-rank') 


通过 title 和 body 字段 ， 上 述 代码 针对 设置 的 搜索 向 量 使 用 了 不 同 的 权 值 。 其 中 ， 默 
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认 权 值 为 D、C、B 和 A， 分 别 对 应 于 数值 0.1、0.2、0.4 和 1.0。 相 应 地 ，title 搜索 向 量 
使 用 了 权 值 1.0， 而 body 向量 使 用 了 权 值 0.4: 标题 匹配 将 超过 正文 内 容 匹 配 。 我 们 将 对 
结果 进行 过 滤 ， 且 仅 显 示 排 名 大 于 0.3 的 相关 结果 。 


3.4.7 ”利用 三 元 相似 性 进行 搜索 


三 元 相似 性 则 是 另 一 种 搜索 方案 。 这 里 ， 三 元 表示 为 3 个 连续 字符 构成 的 组 合 ， 
过 计算 共有 的 三 元 数量 ， 可 测算 两 个 字符 串 的 相似 性 。 对 于 多 种 语言 中 的 单词 相似 性 计 
算 ， 该 方案 非常 高 效 。 

当 在 PostgreSQL 中 使 用 三 元 方案 时 , 首先 需要 安装 pg_trgm 扩展 , 并 在 Shell 中 执行 
下 列 命 令 以 连接 数据 库 : 

psql blog 

随后 ， 执 行 下 列 命令 并 安装 pg_trgm 扩展 : 

CREATE EXTENSION pg_trgm; 

下 面 对 视 图 进行 编辑 、 修改 , 并 执行 三 元 搜索 。 对 此 , 编辑 blog 应 用 程序 的 views.py 
文件 ， 并 加 入 下 列 导 入 语句 : 

from django.contrib.postgres.search import TrigramSsimilarity 

随后 利用 下 列 代 码 行 蔡 换 Post 搜索 查询 : 


results = Post.objects .annotate( 
similarity=TrigramSimilarity('title', query), 
-Fi1ter (similarity gt=0.3) .order by('-similarity') 


在 浏览 器 中 打开 http://127.0.0.1:8000/blog/search/， 并 测试 不 同 的 三 元 搜索 。 图 3.11 
显示 了 django 中 的 一 个 假定 的 输入 错误 ， 并 显示 了 yango 的 搜索 结果 。 


Posts containing "yango" 


Found 1 result 
Django Django 


A Python web framework. 


图 3.11 
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至 此 ， 我 们 在 项 目 中 实现 了 功能 强大 的 搜索 引擎 。 关 于 全 文本 搜索 ， 读 者 可 访问 
https://docs.djangoproject.com/en/2.0/ref/contrib/postgres/search/ 以 了 解 更 多 内 容 。 


3.4.8 其 他 全 文本 搜索 引擎 


读者 可 能 还 会 使 用 到 其 他 全 文本 搜索 引擎 ， 且 有 别 于 PostgreSQL， 如 Solr 或 
Elasticsearch。 对 此 ， 可 利用 Haystack 将 其 整合 至 项 目 中 。Haystack 是 一 个 Django 应 用 
程序 , 并 可 视 作 多 个 搜索 引擎 的 抽象 层 。Haystack 提供 了 与 Django QuerySets 十 分 类 似 的 
简单 搜索 API。 读 者 可 访问 http://haystacksearch.org/ 以 了 解 与 Haystack 相关 的 更 多 信息 。 


3.5 本 章 小 结 


本 章 讨论 了 如 何 创建 自 定义 Django 模板 标签 和 过 滤器 ， 进 而 提供 包含 定制 功能 的 模 
板 。 除 此 之 外 ， 本 章 还 针对 搜索 引擎 创建 了 网 站 地 图 ， 供 搜索 引擎 抓 取 站 点 内 容 ， 以 及 
-个 RSS 提要 以 供用 户 订阅 博客 。 最 后 ， 本 章 通过 PostgreSQL 的 全 文本 搜索 引擎 并 针对 
博客 设置 了 搜索 引擎 。 
第 4 章 将 学 习 如 何 利 用 Django 验证 框架 构建 社交 网 站 、 设 置 用 户 配置 文件 、 构 建 验 
证 机 制 。 
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第 3 章 介 绍 了 如 何 创建 网 站 地 图 和 摘要 ， 并 对 boke 应 用 程序 构建 搜索 引擎 。 本 章 将 


开发 一 个 社交 应 用 程序 ， 并 为 用 户 创建 登录 、 注 销 、 编 辑 以 及 密码 重 置 等 功能 。 此 外 ， 
本 章 还 将 学 习 如 何 设置 用 户 的 自 定义 配置 文件 ， 并 向 网 站 中 添加 验证 机 制 。 
本 章 主要 涉及 以 下 内 容 : 


口 
口 
口 
口 


使 用 Django 授权 框架 。 
创建 用 户 注册 视图 。 

利用 自 定义 配置 模型 扩展 用 户 模型 。 
添加 授权 机 制 。 


下 面 将 开始 构建 新 项 目 


本 节 


4.1 设计 社交 型 网 站 


将 介绍 如 何 构建 社交 型 应 用 程序 , 用户 可 以 此 共享 他 们 在 互联 网 中 搜索 的 照片 。 


针对 该 项 目 ， 需 要 设置 以 下 元 素 : 


口 


口 
口 
口 
pe 


cal 


用 户 验 证 系统 ， 以 实现 注册 、 登 录 、 配 置 文件 的 编辑 以 及 密码 的 修改 和 重 置 等 
操作 。 
关注 系统 ， 以 使 用 户 间 可 彼此 查看 。 

显示 共享 照片 ， 并 实现 用 户 的 标签 工具 ， 进 而 共享 来 自任 意 网 站 的 图 像 。 
每 名 用 户 的 操作 流 ， 以 使 用 户 可 查看 所 关注 用 户 的 上 传 内 容 。 


章 将 对 此 进行 逐一 讨论 。 


终端 ， 使 用 下 列 命 令 创 建 项 目 虚拟 环境 并 激活 该 项 目 : 


mkdir env 
Virtualenv env/bookmarks 
source env/bookmarks/bin/activate 


Shell 提示 符 将 显示 处 于 活动 状态 下 的 虚拟 环境 ， 如 下 所 示 : 


(bookmarks) laptop:~ zenx$ 


利 


下 列 命令 在 虚拟 环境 下 安装 Django: 


pip install Django==2.0.5 
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运行 下 列 命令 并 创建 新 项 目 : 
django-admin startproject bookmarks 


在 创建 了 初始 项 目 结构 后 ,通过 下 列 命 令 查 看 项 目 字典 ， 并 创建 名 为 account 的 新 应 


用 枉 厅 。 
cd bookmarks/ 
django-admin startapp account 
注意 ,这 里 应 激活 项 目 中 的 新 应 用 程序 ， 也 就 是 说 , 将 其 添加 至 settings.py 文件 中 的 
程序 之 前 将 其 置 于 INSTALLED 


INSTALLED_APPS 设置 中 ， 并 在 其 他 安装 后 的 应 月 
APPS 列表 中 ， 如 下 所 示 : 


INSTALLED APPS = [ 
"account .apps.AccountConfig', 


] 
稍 后 将 定义 Django 的 验证 模板 。 通 过 在 INSTALLED_APPS 设置 中 放置 当前 应 用 程 
序 ， 可 确保 验证 模板 在 默认 状态 下 予以 使 用 ， 而 非 其 他 应 用 程序 中 的 验证 模板 。Django 


根据 应 用 程序 在 INSTALLED_APPS 设置 中 的 出 现 顺序 查找 模板 。 
运行 下 列 命 令 ， 将 数据 库 与 INSTALLED_APPS 设置 中 包含 的 默认 应 用 程序 模型 同步 : 


Python manage.py migrate 
随后 将 会 看 到 ， 全 部 初始 状态 下 的 Django 数据 库 迁移 均 已 投入 使 用 。 下 面 将 通过 
Django 的 验证 系统 框架 构建 我 们 的 验证 系统 。 


4.2 ”使 用 Django 验证 框架 


Django 包含 了 内 置 的 验证 系统 ， 并 可 处 理 用 户 验证 、 会 话 、 许 可 权限 以 及 用 户 组 。 
验证 系统 包含 了 常见 用 户 行为 的 视图 ， 如 登录 、 注 销 、 密 码 修 改 以 及 密码 重 置 。 

验证 框架 位 于 django.contrib.auth 中 ， 其 他 Django contrib 数据 包 也 可 对 此 加 以 使 用 。 
忆 一 下 ,第 1 章 中 已 经 使 用 了 验证 框架 , 并 生成 了 blog 应 用 程序 的 超级 用 户 以 访问 管理 站 点 。 
startproject 命令 创建 新 的 Django 项 目 时 ， 验 证 框架 包含 在 项 目的 默认 设置 中 ， 
包括 django.contrib.auth 应 用 程序 , 以 及 下 列 两 个 项 目 MIDDLEWARE 设置 中 的 中 间 件 类 。 
口 “AuthenticationMiddleware: 使 用 会 话 将 用 户 与 请 求 关联 起 来 。 


口 ” SessionMiddleware: 处 理 请 求 间 的 当前 会 话 。 


日 


当 使 


第 4 章 ， 构 建 社交 型 网 站 


。85。 


中 间 件 表示 为 一 个 类 , 其 中 包含 了 一 些 方法 , 可 在 请 求 或 响应 阶段 以 全 局 方式 被 执行 。 


我 们 将 在 多 种 场合 下 使 用 到 中 间 件 类 。 此 外 ， 第 13 章 还 将 学 习 如 何 创建 自 定义 中 间 件 。 


验证 系统 涵盖 了 下 列 模块 : 


口 ”User 表 示 包 含 基本 字段 的 用 户 模块 , 该 模块 的 主要 字段 包括 username、password、 


email、first name、last name 以 及 is_active。 
口 ”Group 表示 分 组 模块 ， 以 对 用 户 进行 分 类 。 
口 ”Permission 表示 用 户 或 分 组 标记 ， 并 执行 特定 的 操作 。 


除 此 之 外 ， 该 框架 还 包含 了 默认 的 验证 视图 ， 以 及 供 后 续 操作 使 
4.2.1 构建 登录 视图 


的 表单 。 


本 节 将 使 用 Dijango 验证 框架 使 得 用 户 可 登录 当前 网 站 。 对 应 的 视图 将 执行 下 列 操作 ， 


从 而 实现 用 户 的 登录 行为 。 
(1) 通过 发 布 表 单 获得 用 户 名 和 密码 。 
(2) 利用 存储 于 数据 库 中 的 数据 对 用 户 进行 验证 。 
(3) 检查 用 户 是 否 属于 活动 状态 。 
(4) 用 户 登 录 网 站 并 启动 验证 会 话 。 


下 面 首先 创建 登录 表单 。 在 account 应 用 程序 目录 中 创建 新 的 forms.py 文件 ， 并 添加 


下 列 代码 行 : 
from django import forms 


class LoginForm(forms.Form): 
username = forms .CharField() 


password . forms.CharField (widget=forms.PasswordInput) 
根据 当前 数据 库 ， 该 表单 用 于 对 用 户 进行 验证 。 需 要 注意 的 是 ， 此 处 采用 了 
PasswordInput 微 件 显示 其 HTML input 元 素 ， 同 时 包含 type="password" 属 性 ， 以 使 浏览 
器 可 将 其 视 作 密码 输入 。 编 辑 account 应 用 程序 的 views.py 文件 ， 并 向 其 添加 下 列 代码 : 


from django .http import HttpResponse 

from django .shortcuts import render 

from django .contrib .auth import authenticate, login 
from .forms import LoginForm 


def user login (request): 
if request.method == 'POST': 
form = LoginForm(request .POST) 
if form.is valid(): 
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cd = form.cleaned data 
user = authenticate (request, 
username=cd['username'], 
password=cd['password"']) 
if user is not None: 
if user.is active: 
login(request, user) 
return HttpResponse('Authenticated '\ 
'successfully') 


elses 
return HttpResponse('Disabled account') 
else: 
return HttpResponse('Invalid login') 
else: 


form = LoginForm() 
return render(request, 'account/login.html', {'form': form}) 


上 述 代 码 表示 为 基本 的 登录 视图 所 执行 的 任务 : 当 user_login 视图 通过 GET 请 求 被 
调用 时 ， 将 利用 form = LoginForm() 实 例 化 新 的 登录 表单 ， 并 将 其 显示 于 模板 中 。 当 用 户 
通过 POST 提交 表单 时 ， 将 执行 下 列 操作 : 

(1) 利用 form =LoginForm(request.POST) 实 例 化 包含 提交 数据 的 表单 。 

(2) 利用 form.is_valid0 检 测 表 单 是 否 有 效 。 若 否 ， 则 在 当前 模板 中 显示 表单 错误 信 
息 〈 例 如 ， 用 户 未 填写 其 中 的 某 个 字段 ) 。 

(3) 如 果 所 提交 的 数据 有 效 ， 则 通过 authenticate() 方 法 并 根据 数据 库 对 用 户 予 以 验 
证 。 该 方法 接收 request 对 象 、username 以 及 password 参数 ， 并 返回 User〈 用 户 验证 成 
功 ) 或 None。 如 果 用 户 验证 失败 ， 则 返回 原 2 同时 显示 Invalid Login 消息 。 

C4) 如 果 用 户 验 证 成 功 ， 将 检测 该 用 户 是 否 处 于 活动 状态 ， 即 访问 其 is_active 属性 。 
该 属性 定义 为 Django 的 用 户 模 型 属性 。 若 用 户 未 处 于 活动 状态 ， 则 返回 HttpResponse 
显示 Disabled account 消息 。 
(5) 若 用 户 处 于 活动 状态 ， 则 登录 网 站 。 通 过 调用 login() 方 法 ， 可 在 当 
置 该 用 户 ， 并 返回 Authenticated successfully 消息 。 
© 注意 ， 

此 处 应 注意 authenticate 和 login 之 间 的 差别 。authenticate() 检 测 用 户 凭 证 ， 若 正确 
则 返回 User 对 象 ; 而 login() 则 在 当前 会 话 中 设置 用 户 。 


随后 需要 针对 视图 创建 URL 路 径 。 对 此 , 在 account 应 用 程序 目录 中 创建 新 的 urls.py 
文件 ， 并 添加 下 列 代码 : 


from django.urls import path 


上 
EE 
阔 
瑟 
< 
涉 
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from . import views 


Urlpatterns = [ 
# post views 
path('login/', views.user login, name='login'), 


] 
编辑 bookmarks 项 目 目录 中 的 urlspy 主 文件 、 导 入 include 并 添加 account 应 用 程序 
的 URL 路 径 ， 如 下 所 示 : 


from django.conf.urls import path, include 
from django.contrib import admin 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('account/', include('account.urls')), 


] 


al 


4 前 ， 登 录 视 图 可 通过 URL 访问 ， 下 面 针 对 该 视图 创建 模板 。 鉴 于 当前 项 目 尚未 包 
含 任何 模板 ， 我 们 可 开始 着 手 创建 一 个 由 登录 模板 扩展 的 基本 模板 。 对 此 ， 可 在 account 
应 用 程序 目录 中 创建 下 列 文件 和 目录 : 


templates/ 
account/ 
login.html 
base.html 


编辑 base.html 文件 并 添加 下 列 代码 : 


{s load staticfiles %} 
<!DOCTYPE html> 
<html> 
<head> 
<title>{% block title %}{% endblock %}</title> 
<link href="{% static "css/base.css" %}" rel="stylesheet"> 
</head> 
<body> 
<div id="header"> 
<span class="]l0go">Bookmarks</span> 
</div> 
<div id="content"> 
{$$ block content 当 } 
{$$ endblock $} 
</div> 
</body> 
</html> 
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这 将 视 为 当前 网 站 的 基本 模板 。 如 同 之 前 项 目 所 做 的 那样 ， 可 在 主 模板 中 包含 CSS 
样式 。 此 类 静态 文件 位 于 本 章 的 示例 源 代码 中 。 相 应 地 ， 可 将 account 应 用 程序 的 static/ 
目录 从 本 章 的 源 代码 复制 至 项 目的 相同 位 置 ， 以 便 使 用 这 些 静 态 文件 。 

基本 模板 定义 了 一 个 tile 块 和 content 块 ， 可 由 从 中 扩展 的 模板 填充 相关 内 容 。 

下 面 针 对 登录 表单 填充 模板 。 对 此 ， 打 开 account/login.html 模板 并 添加 下 列 代码 ; 


{$$ extends "base.html™ %} 


{%s block title %}Log-in{% endblock %} 


{% block content $%} 
<hl>Log-in</h1l> 
<p>Please, use the following form to log-in:</p> 
<form action="." method="post"> 
{{ form.as p }} 
{$$ csrf token %} 
<p><input type="submit" value="Log in"></p> 
</form> 
{$$ endblock $} 


该 模板 包含 了 视图 中 实例 化 的 表单 .考虑 到 当前 表单 通过 POST 提交, 因而 针对 CSRF 
保护 包含 了 {% csrf_token %} 模 板 标签 。 关 于 CSRF 保护 ， 读 者 可 参考 第 2 章 。 

当前 数据 库 中 未 包含 任何 用 户 ， 因 而 首先 需要 创建 超级 用 户 ， 进 而 可 访问 管理 站 点 并 对 
其 他 用 户 进行 管理 。 打 开 命 令 行 工具 并 执行 python manage.py createsuperuser 命令 , 填充 期 望 
的 用 户 名 、 邮 件 地 址 以 及 密码 。 随 后 ， 利 用 python manage.py runserver 命令 运行 开发 服务 
器 ， 并 在 浏览 器 中 打开 http:/127.0.0.1:8000/admin/， 并 通过 刚刚 创建 的 用 户 凭 证 访问 管理 
站 点 。 图 4.1 显示 了 Django 管理 站 点 , 其 中 包含 了 Django 验证 框架 的 User 和 Group 框架 。 


[BJlelalelo Nleln lilireldeln WELCOME, ADMIN. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Site administration 


AUTHENTICATION AND AUTHORIZATION 


Recent actions 
Groups + Add Change 


Users + Add Change My actions 


None available 
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通过 管理 站 点 创建 新 用 户 ， 并 在 浏览 器 中 打开 http://127.0.0.1:8000/account/login/。 所 
显示 的 模板 如 图 4.2 所 示 ， 其 中 包含 了 登录 表单 。 


127.0.0.1:8000/account/login/ 


Bookmarks 


Log-in 


Please, use the following form to log-in: 


Username: 


Password: 


图 4.2 


提交 表单 ， 并 保持 其 中 的 一 个 字段 为 空 。 此 时 ， 表 单 处 于 无 效 状 态 ， 同 时 还 将 显示 
错误 信息 ， 如 图 4.3 所 示 。 


Username: 


test 


This field is required. 


Password: 
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注意 ， 一 些 现代 浏览 器 无 法 提交 包含 空 字段 或 错误 字段 的 表单 ， 其 原因 在 于 : 浏览 
器 根据 字段 类 型 和 每 个 字段 的 限制 条 件 执行 表单 验证 。 在 当前 示例 中 ， 表 单 提交 失败 ， 
同时 还 将 针对 无 效 字 段 显示 错误 消息 。 

此 外 ， 如 果 输 入 了 不 存在 的 用 户 或 者 无 效 密码 ， 将 会 显示 Invalid login 消息 。 

在 输入 了 正确 的 凭证 信息 后 ， 将 会 显示 如 图 4.4 所 示 的 Authenticated successfully 消息 。 


127.0.0.1:8000/account/login/ © 


Authenticated successfully 


4.2.2 使 用 Django 验证 视图 


Django 在 验证 框架 中 包含 了 多 个 表单 和 视图 。 其 中 ， 我 们 所 创建 的 登录 视图 可 视 为 
-个 较 好 的 练习 ,进而 可 较 好 地 理解 Django 中 的 用 户 验 证 处 理 过 程 。 然 而 , 大 多 数 时 候 ， 
我 们 可 使 用 默认 的 Django 验证 视图 。 
Django 提供 了 下 列 基于 类 的 视图 ， 以 对 验证 过 程 加 以 处 理 。 全 部 视图 均 位 于 
django.contrib.auth views 中 ， 例 如 。 
口 LoginView: 处 理 登录 表单 并 实现 用 户 登 录 操 作 。 
口 LogoutView: 注销 某 个 用 户 。 
Django 提供 了 下 列 视图 可 处 理 密 码 修改 操作 。 
口 ”PasswordChangeView: 处 理 某 个 表单 并 修改 用 户 密码 。 
口 ”PasswordChangeDoneView: 密码 被 成 功 修改 后 , 用 户 将 被 重 定 向 至 成 功 视图 页 面 。 
此 外 ，Django 还 包含 了 下 列 视图 ， 使 得 用 户 可 重 置 密码 。 
口 ”PasswordResetView: 允许 用 户 重 定向 密码 ,并 生成 包含 令 牌 的 一 次 性 使 用 链接 ， 
同时 将 其 发 送 至 用 户 的 电子 邮箱 账户 中 。 
口 ”PasswordResetDoneView: 通知 用 户 ， 一 封 电 子 邮 件 〈 包 含 重 置 密码 的 链接 ) 已 
口 PasswordResetConfirmView: 人 允许 用 户 设 置 新 的 密码 。 
口 ”PasswordResetCompleteView: 密码 重 置 成 功 后 ,用户 被 重 定向 至 成 功 视图 页 面 。 
当 通 过 用 户 账户 创建 一 个 站 点 时 ， 上 述 各 项 视图 可 节省 大 量 的 时 间 。 这 一 类 视图 采 
了 可 履 写 的 默认 值 ， 如 所 显示 的 模板 位 置 ， 或 者 视图 所 使 用 的 表单 。 
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关于 内 置 的 验证 视图 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/auth/ 
default/#all-authentication-views 以 了 解 更 多 内 容 。 


4.2.3 ”登录 和 注销 视图 


编辑 account 应 用 程序 的 urls.py 文件 ， 如 下 所 示 : 


from django.urls import path 
from django.contrib.auth import views as auth views 
from . import views 


urlpatterns = [ 
# previous login view 
# path('login/', views.user login, name='login’'), 
path('login/', auth views.LoginView.as view(), name='login'), 
path('logout/', auth views.LogoutView.as view(), name='logout'), 
] 
对 于 刚刚 创建 的 user_login 视图 ， 我 们 注释 掉 URL 路 径 ， 并 使 用 Django 验证 框架 的 
LoginView 视图 。 此 外 ， 还 向 LoginView 视图 中 添加 了 一 个 URL 路 径 。 
在 account 应 用 程序 化 的 templates 目录 中 生成 一 个 新 目录 , 并 将 其 命名 为 registration 。 
这 是 Django 身份 验证 视图 所 期 望 的 验证 模板 的 默认 路 径 。 
django.contrib.admin 模块 中 包含 了 一 些 用 于 管理 站 点 的 验证 模板 。 我 们 曾 将 account 
应 用 程序 置 于 INSTALLED_APPS 设置 的 开始 处 ， 以 使 Django 用 户 在 默认 状态 下 使 用 模 
板 ， 而 非 定义 于 其 他 应 用 程序 中 的 验证 模板 。 
在 templates/registration 目录 中 创建 新 文件 ， 将 其 命名 为 login.html 并 添加 下 列 代码 : 


{% extends "base.htm]l™" %} 


{ 当 block title %}Log-in{% endblock %} 


{gs block content 要 } 
<hl>Log-in</hl> 
{SS if form.errors %®} 
<p> 
Your username and password didn't match. 
Please try again. 
</p> 
{ 和 要 else $} 
<p>Please, use the following form to log-in:</p> 
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{SS endif 村 } 
<div class="login-form"> 
<form action="{$% url 'login' %}" method="post"> 
a ormas pp 0}F 
{SS csrf token 当 } 
<input type="hidden" name="next" value="{{ next }}" /> 
<p><input type="submit" value="Log-in"></p> 
</form> 
</div> 
{% endblock %} 


该 登录 模板 与 之 前 创建 的 模板 十 分 类 似 。 默 认 状 态 下 ，Django 使 用 位 了 
contrib.auth.forms 中 的 AuthenticationForm 表单 ， 这 一 表单 尝试 对 
失败 ， 则 产生 验证 错误 。 


F django. 
日 户 进行 验证 ， 若 登录 
此 处 ,我 们 可 利用 模板 中 的 {% fform.errors %} 查 找 错误 ， 并 检 
测 所 提供 的 凭证 是 否 正确 。 注 意 ， 之 前 加 入 了 隐 含 的 HTML<input> 元 素 提 交 名 为 next 
的 变量 值 。 当 传递 请 求 中 的 next 参数 时 (如 http://127.0.0.1:8000/account/login/?next=/ 
account/) ， 该 变量 首先 由 登录 表单 进行 设置 。 

这 里 ，next 参数 须 表 示 为 一 个 URL。 若 该 参数 已 被 设置 ，Django 视图 将 在 成 功 登录 
后 将 用 户 重 定向 至 既定 URL 处 。 

下 面 在 registration 模板 目录 中 创建 logged_out.html 模板 ， 如 下 所 示 : 

{% extends "base.html" %} 


{$$ block title %}Logged out{% endblock %} 


{% block content $%} 
<hl>Logged out</h1> 


<p>You have been successfully logged out. You can <a href="{% Url 
"login" %}">log-in again</a>.</p> 

{ 当 endblock $} 

在 用 户 注 销 后 ，Django 将 显示 该 模板 。 

在 添加 了 URL 路 径 、 登 录 模板 以 及 注销 视图 后 ， 站 点 月 
进行 登录 。 

接 下 来 ， 当 用 户 登录 其 账户 后 ， 我 们 将 创建 一 个 显示 视图 。 对 此 ， 打 开 account 应 用 
程序 的 views.py 文件 ， 并 添加 下 列 代码 : 


户 可 通过 Django 验证 视图 


from django.contrib.auth.decorators import login required 


@login required 
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def dashboard (request): 
return render (request, 
'account/dashboard.html', 
{'section': 'dashboard'}) 
此 处 采用 了 验证 框架 中 的 login_required 装饰 器 对 视图 予以 修饰 。login_required 装饰 
器 检测 当前 用 户 是 否 已 被 验证 。 若 是 ， 则 执行 装饰 后 的 视图 ， 若 否 ， 则 利用 最 初 请 求 的 
URL 作为 参数 〈 名 为 next) 将 用 户 重 定向 至 登录 URL。 据 此 ， 在 成 功 登 录 后 ， 登 录 视 图 
将 用 户 重 定 向 至 试图 访问 的 URL 处 。 对 此 ， 我 们 在 登录 模板 表单 中 加 入 了 隐藏 的 输入 。 
除 此 之 外 ， 我 们 还 定义 了 section 变量 ， 并 使 用 该 变量 跟踪 用 户 浏 览 的 站 点 部 分 。 相 
应 地 ， 多 个 视图 可 对 应 于 同一 部 分 内 容 。 当 定义 每 个 视图 对 应 的 部 分 时 ， 这 可 视 为 一 种 
简单 的 方式 。 
下 面 针对 dashboard 视图 创建 一 个 模板 。 对 此 ， 在 templates/account/ 目 录 中 创建 一 个 
新 文件 ， 并 将 其 命名 为 dashboard.html， 如 下 所 示 : 


{$$ extends "base.html™" %} 


{% block title %}Dashboard{% endblock %} 


{% block content %} 
<hl>Dashboard</h1> 
<p>Welcome to your dashboard.</p> 
{$$ endblock 当 } 


随后 ， 针 对 该 视图 (位 于 account 应 用 程序 的 urls.py 文件 中 ) ， 添 加 下 列 URL 路 径 : 


urlpatterns = [ 
a 
path('', views.dashboard, name='dashboard'), 


] 

编辑 项 目 中 的 settings.py 文件 ， 并 添加 下 列 代码 : 

LOGIN REDIRECT URL = '"dqashboard'" 

LOGIN URL = "Login' 

LOGOUT URL = "1ogout" 

上 述 代码 中 的 设置 内 容 包括 以 下 方面 。 

口 LOGIN REDIRECT_URL: 如 果 请 求 中 未 出 现 next 参数 ， 在 成 功 登 录 后 ， 将 通 
知 Django 重 定向 的 URL。 

口 LOGIN URL: 用 户 重 定向 并 实现 登录 的 URL〔 例 如 使 用 login_required 装饰 器 


。94 。 


的 视 
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图 ) 。 


口 LOGOUT URL: 用 户 重 定向 并 实现 注销 的 URL。 


之 前 通过 path() 函 数 的 name 属性 定义 的 URL 路 径 名 。 针对 此 类 设置 , 可 


使 用 URL 硬 编码 ， 而 非 URL 名 。 


述 内 容 稍 作 总 结 : 


这 里 使 有 
下 面 对 部 

口 项 目 

口 ”针对 
后 对 

口 最 后 
下 面向 基 

为 了 显示 正 丰 


中 添加 了 内 置 的 Django 验证 登录 和 注销 视图 。 

这 两 个 视图 创建 了 自 定义 模板 ,并 定义 了 简单 的 dashboard 视图 ， 以 在 登录 
用 户 执行 重 定向 操作 。 

， 还 针对 Django 设置 了 某 些 配置 内 容 ， 且 默认 状态 下 将 使 用 这 些 URL。 
础 模板 中 添加 登录 和 注销 链接 ， 同 时 对 各 方 内 容 进 行 整合 。 针 对 每 种 情况 ， 
的 链接 ， 需 要 判断 当前 用 户 是 否 处 于 登录 状态 。 对 此 ， 当 前 用 户 通过 验证 


中 间 件 在 HttpRequest 对 象 中 被 设置 , 并 可 通过 request.user 对 其 进行 访问 。 即 使 用 户 未 被 


验证 ， 仍 可 在 
设置 。 检 测 当 


请 求 中 获取 User 对 象 。 非 验证 用 户 将 作为 AnonymousUser 实例 在 请 求 中 被 
前 用 户 是 否 被 验证 的 最 佳 方式 是 访问 器 只 读 属 性 is_authenticated。 


编辑 base.html 模板 ， 并 使 用 header ID 修改 <div> 元 素 ， 如 下 所 示 : 


<div id="header"> 


<span 


class="1ogo">Bookmarks</span> 


{% if request.user.is authenticated %} 
<ul class="menu"> 


< 


过 
< 


<, 
< 


< 


li {% if section == "dashboard" %}class="selected"{% endif %}> 
<a href="{% Url "dashboard" %}">My dashboard</a> 

/1i> 

li {% if section == "images" %}class="selected"{% endif %}> 
<a href="#">Images</a> 

/li> 

li {% if section == "people" %}class="selected"{% endif %}> 
<a href="#">People</a> 

/1i> 


</ul> 
{% endif %} 


<span class="user"> 


{% 
H 
< 

{% 

<a 


if request.user.is authenticated %} 
lello {{ request.user.first name }}, 

a href="{% url "logout" %}">Logout</a> 
else %} 

href="{% Url "login" $%}">Log-in</a> 
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{% endif %} 

</span> 

</div> 

不 难 发 现 ， 上 述 代 码 仅 向 验证 后 的 用 户 显 示 了 站 点 菜单 。 此 外 ,还 检测 了 当前 部 分 
并 向 对 应 的 <li> 项 添加 了 selected 类 属性 ， 并 通过 CSS 着 重 显示 了 菜单 中 的 当前 内 容 。 
除 此 之 外 ， 如 果 用 户 已 被 验证 ， 还 将 显示 用 户 的 姓氏 以 及 注销 链接 ; 否则 将 显示 登录 
链接 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/account/login/， 随 后 将 显示 登录 页 面 。 在 输入 了 
有 效 的 用 户 名 和 密码 后 ， 单 击 Log-in 按钮 。 对 应 输出 结果 如 4.5 图 所 示 。 


Bookmarks Images ”People Hello Antonio, Logout 


Dashboard 


Welcome to your dashboard. 


图 4.5 
可 以 看 到 ，My dashboard 部 分 通过 CSS 被 高 亮 显示 其 中 包含 了 selected 类 。 由 于 


当前 用 户 已 被 验证 ， 因 而 用 户 姓 氏 将 被 显示 于 右 侧 。 单 击 Logout 链接 ， 对 应 结果 如 图 4.6 
所 示 。 


Bookmarks 


Logged out 


You have been successfully logged out. You can Iog-in again. 


图 4.6 


在 图 4.6 所 示 页 面 中 ， 用 户 处 于 注销 状态 ， 因 而 站 点 菜单 将 不 再 被 显示 ; 相应 地 ， 右 
侧 链 接 此 时 将 显示 为 Log-in。 
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人 @ 注意， 

当 看 到 Django 管理 站 点 的 注销 页 面 ( 而 非 用 户 自己 的 注销 页 面 ) 时 ， 应 检测 项 目的 
INSTALLED_ APPS 设置 ， 确 保 django.contrib.admin 位 于 account 应 用 程序 之 后 。 两 个 模 
板 均 位 于 同一 相对 路 径 下 ，Django 模板 加 载 器 将 使 用 第 一 个 搜索 到 的 模板 。 


4.2.4 修改 密码 视图 


在 登录 站 点 后 ， 用 户 可 修改 其 密码 。 对 此 ， 我 们 将 对 Django 验证 视图 进行 整合 。 打 
开 account 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 
# change password urls 
path('password change/', 
auth views.PasswordChangeView.as view(), 
name='password change'), 
path('password change/done/', 
auth views.PasswordChangeDoneView.as view()， 
name='password change done'), 


PasswordChangeView 视图 将 处 理 表单 并 修改 密码 ;在 成 功 修改 密码 后 ， 
PasswordChangeDoneView 视图 将 显示 一 条 成 功 消息 。 下 面 针 对 每 个 视图 创建 一 个 模板 。 

相应 地 , 可 向 account 应 用 程序 的 templates/registration/ 目 录 中 添加 新 文件 , 将 其 命名 
为 password_change_form.html 并 添加 下 列 代码 : 


{s extends "base.html™" $%} 
{% block title %}Change you password{% endblock %} 


{% block content %} 
<hl>Change you password</h1l> 
<p>Use the form below to change your password.</p> 
<form action="." method="post"> 
{{ form.as p }} 
<p><input type="submit" value="Change"></p> 
{% csrf token %} 
</form> 
{$$ endblock $} 


password_change_form.html 模板 包含 了 修改 密码 的 表单 。 下 面 在 同一 目录 中 创建 另 
一 个 文件 ， 将 其 命名 为 password_change_done.html 并 添加 下 列 代码 : 
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{S$ extends "base.html™ $} 
{s block title %}Password changed{% endblock %} 


{% block content %} 

<hl>Password changed</h1> 

<p>Your password has been successfully changed.</p> 
{% endblock $} 


password_change_done.html 模板 仅 包含 了 相应 的 成 功 消息 ， 当 用 户 成 功 修改 密码 后 
予以 显示 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/account/password_change/。 如 果 用 户 尚未 登录 ， 浏 
览 器 将 用 户 重 定向 至 登录 页 面 。 经 过 成 功 验证 后 ， 将 会 看 到 如 图 4.7 所 示 的 密码 修改 页 面 


Bookmarks 


Change you password 
Use the form below to change your password. 


Old password: 


® Your password can't be too similar to your other personal information. 
se Your password must contain at least 8 characters. 

e Your password cant be a commonly used password. 

e Your password can't be entirely numeric. 


New password confirmation: 


图 4.7 
随后 ， 利 用 当前 密码 和 信息 修改 的 密码 填写 表单 ， 并 单 击 CHANGE 按钮 ， 图 4.8 显 
示 了 对 应 的 成 功 页 面 。 
注销 后 再 次 使 用 新 密码 登录 ， 以 确保 工作 一 切 正常 。 
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Hello Antonio, Logout 


Password changed 


Your password has been successfully changed. 


图 4.8 


4.2.5” 重 置 密 码 视图 


针对 密码 重 置 行为 ， 可 向 account 应 用 程序 中 的 urlspy 文件 添加 下 列 URL 路 径 : 


# reset password urls 
path('password reset/', 
auth views.PasswordResetView.as View()， 
name="password reset'), 
path('password reset/done/', 
auth views.PasswordResetDoneView.as view(), 
name="password reset done'), 
path('reset/<uidb64>/<token>/', 
auth views.PasswordResetConfirmView.as view()， 
name='password reset confirm')， 
path('reset/done/', 
auth views.PasswordResetCompleteView.as view(), 
name="'password reset complete'), 


接 下 来 向 account 应 用 程序 的 templates/registration/ 目 录 添 加 新 文件 ， 将 其 
password reset form_ html 并 添加 下 列 代码 : 


{% extends "base.htmlm %} 
{% block title %}Reset your password{% endblock %} 


{ 当 block content %} 
<hl>Forgotten your password?</h1l> 
<p>Enter your e-mail address to obtain a new password.</p> 
<form action="." method="post"> 
{{ form.as p }} 
<p><input type="submit" value="Send e-mail"></p> 
{% csrf token %} 


名 为 
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</form> 
{$s endblock $$} 


随后 ， 在 同一 目录 中 创建 另 一 个 文件 ， 将 其 命名 为 password_reset_email.html 并 添加 
下 列 代码 : 

Someone asked for password reset for email {{ email }}. Follow the link 

below: 


{{ protocol }}://{{ domain }}{s url "password reset confirm" uidb64=uid 
token=token %} 


Your username, in case you've forgotten: {{ user.get username }} 
password_reset_email.html 模板 用 hs 发 送 至 用 户 的 电子 邮件 ， 进 而 对 密码 进行 
在 同一 目录 中 创建 男 一 个 文件 ， 将 其 命名 为 password_reset_done.html 并 添加 下 列 代码 : 
{% extends "base.html™" %} 


{$$ block title %}Reset your password{% endblock %} 


{ 当 block content $%} 
<hl>Reset your password</h1> 
<p>We've emailed you instructions for setting your password.</p> 
<p>If you don't receive an email, please make sure you've entered the 
address you registered with.</p> 
{S$ endblock %} 


在 同一 目录 中 创建 另 一 个 模板 ， 将 其 命名 为 password_reset_confirm.html 并 添加 下 列 
代码 ; 


{ 当 extends "base.htm]l" $%} 
{% block title %}Reset your password{% endblock %} 


{ 当 block content $%} 
<hl>Reset your password</h1l> 
{% if validlink 当 } 
<p>Please enter your new password twice:</p> 
<form action="." method="post"> 
{{ form.as p }} 
{$$ csrf token $} 
<p><input type="submit" value="Change my password" /></p> 
</form> 
{$$ else $} 


<p>The password reset link was invalid, possibly because it has 
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already been used. Please request a new password reset.</p> 
{g% endif %} 
$$ endblock 要 } 
下 面 我 们 将 检测 所 提供 的 链接 是 否 有 效 。 这 里 ， 视 图 PasswordResetConfirmView 负 
责 设置 变量 ， 并 将 其 置 于 password_reset_confirm.html 模板 上 下 文中 。 如 果 链 接 有 效 ， 则 
显示 用 户 密码 重 置 表单 。 
创建 另 一 个 文件 ， 将 其 命名 为 password_reset_complete.html 并 输入 下 列 代码 : 


{$$ extends "base.htm]l™" %} 


{fg%s block title %}Password reset{% endblock $%} 


{ 当 block content $%} 
<hl>Password set</hl> 
<p>Your password has been set. You can <a href="{% url "login" %}">log 
in now</a></p> 
{$$ endblock $} 
最 后 ， 编 辑 account 应 用 程序 的 registration/login.html 模板 ， 并 在 <form> 元 素 后 添加 
下 列 代 码 : 
<p><a href="{% url "password reset" $%}">Forgotten your 
password?</a></p> 
在 浏览 器 中 打开 http://127.0.0.1:8000/account/login/， 并 单 击 Forgotten your password? 
链接 ， 对 应 页 面 如 图 4.9 所 示 。 


Bookmarks 


Forgotten your password? 
Enter your e-mail address to obtain a new password. 


Email: 


SEND E-MAIL 
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此 处 , 需要 向 项 目的 settings.py 文件 中 添加 SMTP 配置 , 以 使 Django 能 够 发 送 邮 件 。 
第 2 章 曾 讲述 了 如 何 向 项 目 中 添加 邮件 设置 。 然而 , 在 开发 过 程 中 , 可 能 需要 配置 Django 
以 向 标准 输出 中 编写 邮件 ， 而 不 是 通过 SMTP 服务 器 发 送 邮 件 。 对 此 ，Django 提供 了 电 
子 邮 件 后 端 , 并 可 向 控制 台 编写 邮件 。 对 此 , 编辑 项 目的 settings.py 文件 并 添加 下 列 代码 : 


EMAIL BACKEND = 'django.core.mail.backends.console.EmailBackend' 


EMAIL BACKEND 设置 表明 发 送 邮件 所 使 用 的 相关 类 。 
返回 至 浏览 器 中 ， 输 入 用 户 的 电子 邮件 地 址 ， 并 单 击 SEND E-MAIL 按钮 ， 对 应 页 
面 如 图 4.10 所 示 。 


Bookmarks 


Reset your password 


Weve emailed you instructions for setting your password. 


lf you dont receive an email, please make sure youve entered the address you registered with . 


图 4.10 
下 面 查看 运行 开发 服务 器 的 控制 台 ， 生 成 的 邮件 如 下 所 示 : 


Content-Type: text/plain; charset="utf-8" 
MIME-Version: 1.0 

Content-Transfer-Encoding: 7bit 

Subject: Password reset on 127.0.0.1:8000 

From: webmaster@localhost 

To: user@domain.com 

Date: Fri, 15 Dec 2017 14:35:08 -0000 

Message-ID: <20150924143508.62996.55653@zenx.local> 


Someone asked for password reset for email user@domain.com. Follow the link 
below: 

http://127.0.0.1:8000/account/reset/MQ/45f-9c3f30caafd523055fcc/ 

Your username, in case you've forgotten: zenx 


此 处 ， 邮 件 通 过 刚刚 创建 的 password_reset_email.html 模板 予以 显示 。 重 置 密码 的 


URL 包含 了 Django 自动 生成 的 令 牌 .复制 该 URL 并 在 浏览 器 中 打开 , 对 应 页 面 如 图 4.11 
所 示 。 
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Bookmarks 


Reset your password 


Please enter your new password twice: 


New password: 


。 Your password can't be too similar to your other personal information. 
。 Your password must contain at least 8 characters. 

» Your password can't be a commonly used password. 

。 Your password can't be entirely numeric. 


New password confirmation: 


CHANGE MY PASSWORD 


图 4.11 


设置 新 密码 的 页 面 对 应 于 password_reset_confirm.html 模板 。 输 入 新 的 密码 并 单 击 
CHANGE MY PASSWORD 按钮 。Django 将 生成 一 个 最 新 加 密 的 密码 ， 并 将 其 保存 至 数 
据 库 中 ， 对 应 成 功 页 面 如 图 4.12 所 示 。 


Bookmarks 


Password set 


Your password has been set. You can log in now 


图 4.12 


随后 ， 可 使 用 新 密码 登录 至 账户 中 。 

注意 ， 设 置 新 密码 的 每 个 令 牌 仅 可 使 用 一 次 。 如 果 再 次 打开 链接 ， 将 得 到 一 条 消息 
表示 令 牌 无 效 。 
当前 项 目 中 已 经 整合 了 Django 验证 框架 视图 ， 此 类 视图 适用 于 大 多 数 场合 。 然 而 ， 
对 于 不 同 的 操作 行为 ， 也 可 创建 自己 的 视图 。 

Django 也 提供 了 我 们 创建 的 验证 URL 路 径 。 我 们 可 注释 掉 添加 至 account 应 用 程序 
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urlspy 文件 中 的 验证 URL 路 径 ， 并 包含 django.contrib auth_urls， 如 下 所 示 : 


from django.urls import path, include 


A 


urlpatterns = [ 
# 


path('', include('django.contrib.auth.urls')), 
] 


读者 可 访问 https://github.com/django/django/blob/stable/2.0.x/django/contrib/auth/urls.py， 
并 查看 所 包含 的 验证 URL 路 径 。 


4.3 用 户 注册 和 用 户 配置 


当前 ， 现 有 用 户 可 执行 登录 、 注 销 、 修 改 密码 以 及 重 置 密码 操作 。 接 下 来 ， 还 需要 
构建 一 个 视图 ， 并 可 使 访问 者 创建 用 户 账户 。 


4.3.1 用 户 注册 


下 面 创 建 一 个 简单 的 视图 ， 以 使 用 户 可 在 网 站 上 进行 注册 。 开 始 时 ， 我 们 需要 创建 
-个 表单 ， 用 户 可 以 此 输入 用 户 名 、 真 实 姓名 以 及 密码 。 对 此 ， 编 辑 account 应 用 程序 目 
录 中 的 forms.py 文件 ， 并 添加 下 列 代码 : 


from django.contrib.auth.models import User 


class UserRegistrationForm(forms.ModelForm): 
password = forms.CharField (label='Password', 


widget=forms .PasswordInput) 
password2 = forms.CharField(label='Repeat password' 


widget=forms .PasswordInput) 


class Meta: 
model = User 


fields = ('username', 'first name', 'email') 


def clean password2 (self): 
cd = self.cleaned data 
if cd['password'] != cd['password2']: 
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raise forms.ValidationError('Passwords don\'t match.') 
return cd['password2'"] 

此 处 针对 用 户 模型 创建 了 一 个 模型 表单 。 在 该 表单 中 ， 仅 包含 了 模型 的 usemame、 
first_name 以 及 email 字段 ， 此 类 字段 将 根据 其 对 应 的 模型 字段 进行 验证 。 例 如 ， 如 果 
户 选 择 了 已 有 的 用 户 名 , 将 会 得 到 一 条 验证 错误 消息 一 一 usemame 字段 通过 unique=True 
加 以 定义 。 除 此 之 外 ， 我 们 针对 用 户 还 添加 了 两 个 附加 字段 ， 即 password 和 password2， 
用 于 设置 密码 以 及 确认 操作 。 此 外 ,还 定义 了 clean_password2() 方 法 ， 并 对 两 次 输出 的 密 
码 进行 检测 。 如 果 密 码 间 不 匹配 ， 表 单 将 不 执行 验证 操作 。 当 调用 is_valid() 方 法 验证 表 
单 时 ， 将 会 执行 该 检测 行为 。 我 们 可 向 任意 表单 方法 提供 一 个 clean <fieldname>() 方 法 ， 
以 清空 数值 或 者 针对 特定 字段 生成 表单 验证 错误 。 另 外 , 表单 还 包含 了 一 个 通用 的 clean() 
方法 ， 并 对 整体 进行 验证 ， 这 对 于 彼此 间 相 互 依赖 的 字段 验证 来 说 十 分 有 用 。 

Django 还 提供 可 一 个 可 用 的 UserCreationForm 表单 日 位 于 django.contrib.auth.forms。 
该 表单 与 之 前 生成 的 表单 十 分 类 似 。 

编辑 account 应 用 程序 的 views.py 文件 并 添加 下 列 代码 : 


from .forms import LoginForm, UserRegistrationForm 


def register (request) : 
if request.method == 'POST' : 
user form = UserRegistrationForm(request.POST) 
if user form.is valid(): 
# Create a new user object but avoid saving it yet 
new user = user form.save (commit=False) 
# Set the chosen password 
new user.set password( 
user form.cleaned data['password']) 
# Save the User object 
new user.save() 
return render(request, 
1account/ register done.html', 
{'new user': new user}) 
else: 
user form = UserRegistrationForm() 
return Trender (equest， 
account/register.html' ， 
{'user form': user form}) 


该 视图 用 于 创建 用 户 账户 且 操 作 过 程 十 分 简单 。 这 里 并 不 保存 用 户 输入 的 原始 密码 ， 
我 们 采用 用 户 模 型 的 方法 set password0 处 理 加 密 ， 并 从 安全 角度 出 发 予以 保存 。 
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编辑 account 应 用 程序 的 urlspy 文件 并 添加 下 列 URL 路 径 : 


path('register/', views.register, name='register'), 


最 后 ， 在 account/ 模 板 目录 中 创建 一 个 新 的 模板 ， 并 将 其 命名 为 register.html， 如 下 
所 示 : 


{$$ extends "base.htm1l" $%} 


im 


{%$ block title %}Create an account{% endblock $%} 


{$$ block content $%} 
<hl>Create an account</h1> 
<p>Please, sign up using the following form:</p> 
<form action="." method="post"> 
{{ user form.as p }} 
{% csrf token %$} 
<p><input type="submit" value="Create my account"></p> 
</form> 
{$% endblock %} 


在 同一 目录 中 添加 模板 文件 ， 将 其 命名 为 register_done.html 并 添加 下 列 代码 : 


{% extends "base.htmln 多 } 
{S$ block title %}Welcome{% endblock %} 


{s% block content %} 

<hl>Welcome {{ new user.first name }}!'</h1l> 

<p>Your account has been successfully created. Now you can <a href="{% 
url "login" %}">log in</a>.</p> 
{% endblock 当 } 


在 浏览 器 中 打开 http://127.0.0.1:8000/account/register/， 注 册页 面 如 图 4.13 所 示 。 
针对 新 用 户 填写 相关 字段 ， 并 单 击 CREATE MY ACCOUNT 按钮 。 如 果 全 部 字段 均 
为 有 效 ， 将 生成 新 用 户 。 图 4.14 显示 了 相应 的 成 功 消息 。 
单 击 log in 链接 ， 输 入 用 户 名 和 密码 ， 并 验证 是 否 可 成 功 访问 账户 。 
比 外 ， 还 可 在 登录 模板 中 加 入 注册 链接 。 对 此 ， 编 辑 registration/login .html 模板 并 
看 下 列 代码 行 : 


<p>Please, use the following form to log-in:</p> 


将 其 蔡 换 为 下 列 代码 行 : 


革 


查 


| 
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<p>Please, use the following form to log-in. If you don't have an account 
<a href="{% url "register" %}">register here</a></p> 


据 此 ， 注 册页 面 可 以 从 登录 页 面 进行 访问 。 


Bookmarks 


Create an account 


Please, sign up using the following form: 


Username: 
Requlred, 150 characters or fewer Letters, diglts and 四 /中 


First name: 


Email address: 


Repeat password: 


图 4.13 


Bookmarks 


Welcome Paloma! 


Your account has been successfully created. Now you can Iog im. 


图 4.14 


4.3.2 ”扩展 用 户 模型 
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当 需 要 处 理 用 户 账户 时 ， 将 会 发 现 Django 验证 框架 中 的 用 户 模型 仅 适 用 于 一 般 场 合 。 
此 类 用 户 模型 包含 了 较为 基本 的 字段 。 对 此 ， 用 户 可 能 希望 扩展 用 户 模型 并 包含 某 些 额 


外 的 数据 。 一 种 较 好 的 方式 是 创建 配置 模型 ， 并 包含 全 部 附加 字段 ， 以 及 与 Django 上 


模型 间 的 一 对 一 关系 。 


坊 


编辑 account 应 用 程序 的 models.py 文件 并 添加 下 列 代码 : 


from django.db import models 
from django.conf import settings 


class Profile (models.Mo 


del): 


user = models.OneToOneField(settings.AUTH USER MODEL, 


on delete=models .CASCADE) 


date of birth = models.DateField (blank=True, null=True) 
photo = models.ImageField (upload to='users/%Y/%m/%d/', 


def StL) 


blank=True) 


return 'Profile for user {}'.format (self.user.username) 


O@ 注意 ， 


为 了 保持 代码 的 通用 性 ,可 使 用 get_user model() 方 法 检索 用 户 模型 和 AUTH USER_ 
MODEL 设置 ,以 便 在 定义 模型 与 用 户 模型 的 关系 时 引用 它 , 而 不 是 直接 引用 认证 的 用 户 


模型 。 


user 一 对 一 字段 可 将 配置 文件 与 用 户 进行 关联 。 对 于 on_delete 参数 ， 我 们 可 使 用 


CASCADE 当 用 户 被 删除 后 


， 其 所 关联 的 配置 文件 也 被 删除 。photo 则 表示 为 一 个 


ImageField 字段 。 另 外 ， 用 户 需 要 安装 Pillow 库 以 对 图 像 进行 处 理 。 在 Shell 中 ， 运 行 下 


列 命令 可 安装 Pillow: 


pip install Pillow==5.1.0 


Django 可 以 通过 开发 服务 器 提供 用 户 上 传 的 媒体 文件 。 对 此 ,可 向 项 目的 settings.py 


文件 添加 下 列 设置 : 


MEDIA URL = '/media/' 


MEDIA ROOT = os.path.join (BASE DIR, "media/ ') 


其 中 ，MEDIA_URL 是 为 | 


户 上 传 的 媒体 文件 提供 服务 的 基 URL, MEDIA _ROOT 
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则 是 用 户 驻 留 的 本 地 路 径 。 我 们 可 根据 当前 项 目 以 动态 方式 构建 路 径 ， 以 使 代码 更 具 通 
性 。 
下 面 编辑 bookmarks 项 目的 urlspy 文件 并 对 代码 进行 修改 ， 如 下 所 示 : 
from django.contrib import admin 

from django.urls import path, include 


from django.conf import settings 
from django.conf.urls.static import static 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('account/', include('account.urls')), 


| 


if settings .DEBUG: 
urlpatterns += static(settings .MEDIRA_URL， 
document root=settings .MEDIA ROOT) 


通过 这 一 方式 ，Django 开发 服务 器 将 负责 在 开发 期 间 为 媒体 文件 提供 服务 (也 就 是 
说 ，DEBUG 设置 为 True) 。 
@ 注意 ， 

static() 帮 助 函 数 适用 于 开发 环境 , 而 非 产品 应 用 环境 , 不 要 在 产品 环境 中 为 Django 
提供 静态 文件 

打开 Shell 并 运行 下 列 命 令 ， 进 而 针对 新 模型 创建 数据 库 迁 移 。 

Python manage.py makemigrations 

对 应 输出 结果 如 下 所 示 : 


Migrations for 'account': 
account/migrations/0001 initial.py 
- Create model Profile 


随后 ， 利 用 下 列 命令 同步 数据 库 : 
Python manage.py migrate 


对 应 输出 结果 如 下 所 示 : 


Applying account.0001 initial... OK 


编辑 account 应 用 程序 的 admin.py 文件 ,在 管理 站 点 中 注册 Profile 模型 ， 如 下 所 示 : 
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from django .contrib import admin 
from .models import Profile 


@admin.register (Profile) 
class ProfileAdmin (admin.ModelAdmin): 
list display = ['user', 'date of birth', 'photo'] 
通过 python managepy runserver 命令 运行 开发 服务 器 ， 并 在 浏览 器 中 打开 http://127.0.0.1: 
8000/admin/。 图 4.15 显示 了 项 目 管理 站 点 中 的 Profiles 模型 。 


ACCOUNT 


Profiles 二 Add Change 


图 4.15 


当前 ， 用 户 可 在 站 点 上 编辑 其 配置 文件 。 对 此 ， 可 向 account 应 用 程序 的 forms.py 文 
件 中 添加 下 列 导 入 语句 : 


from .models import Profile 


class UserEditForm(forms.ModelForm): 
class Meta: 
model = User 
fields = ('first name', 'last name', 'email') 


class ProfileEditForm(forms.ModelForm): 
class Meta: 
model = Profile 
fields = ('date of birth', 'photo') 


上 述 表单 具体 如 下 所 示 : 
口 UserEditForm 人 允许 用 户 编辑 其 名 字 、 姓 氏 以 及 电子 邮件 地 址 ， 这 一 类 内 容 均 为 
内 置 Django 用 户 模 型 中 的 属性 。 


口 ”ProfileEditForm 使 得 用 户 可 编辑 保存 在 自 定义 Profile 模型 中 的 配置 数据 。| 
可 编辑 其 出 生日 期 并 上 传 其 配置 照片 。 
编辑 account 应 用 程序 的 views.py 文件 ， 并 导入 Profile 模型 ， 如 下 所 示 : 


from -models import Profile 


随后 ， 向 new_user.save() 下 方 的 register 视图 中 添加 下 列 代码 行 : 


i 
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# Create the user profile 
Profile.objects.create (user=new user) 


当 用 户 在 站 点 中 注册 时 ， 将 生成 一 个 与 其 关联 的 空 配置 文件 。 对 于 之 前 创建 的 用 户 ， 
须 通 过 管理 站 点 并 通过 手动 方式 创建 一 个 Profile 对 象 。 
对 于 用 户 配置 文件 的 编辑 操作 ， 可 向 同一 文件 中 添加 下 列 代码 : 


from .forms import LoginForm, UserRegistrationForm, \ 
UserEditForm, ProfileEditForm 


@login required 
def edit(request): 
if request.method == 'POST': 

user form = UserEditForm(instance=request.user, 

data=request .POST) 

Profile form = ProfileEditForm( 
instance=request.user.profile, 
data=request.POST, 
files=request .FILES) 

if user form.is valid() and profile form.is valid(): 

user form.save() 
Profile form.save() 
else: 

user form = UserEditForm(instance=request.user) 

Profile form = ProfileEditForm( 
instance=request.user.profile) 

return render(request, 
'account/edit.html', 
{'user form': user form, 
'Profile form': profile form}) 


由 于 用 户 需 要 被 验证 并 编辑 1i 配置 文件 ， 因 而 我 们 将 使 用 login_required 装饰 器 。 此 
处 ， 将 使 用 两 个 模型 表单 ， 其 中 ，UserEditForm 用 于 存储 内 置 用 户 模型 中 的 数据 ， 
ProfileEditForm 则 用 于 存储 自 定义 Profile 模型 中 的 额外 配置 数据 。 当 验证 提交 后 的 数据 
时 ， 需 要 执行 两 个 表单 的 is_valid0 方 法 。 如 果 两 个 表单 均 包含 J 有效 数据 ， 将 调用 save() 
方法 保存 两 个 表单 ， 并 更 新 数据 库 中 的 对 应 对 象 。 

向 account 应 用 程序 中 的 urls.py 文件 添加 下 列 URL 路 径 : 


path('"'edit/', views.edit, name="'edit"'), 


最 后 ,针对 该 视图 ， 在 templates/account/ 中 创建 一 个 模板 ,将 其 命名 为 edit.html 并 添 
加 下 列 代码 : 


第 4 章 构建 社交 型 网 站 “111 
{$$ extends "base.html™ $} 
{%s block title %}Edit your account{s endblock %} 


{$$ block content $%} 
<hl>Edit your account</h1> 
<p>You can edit your account using the following form:</p> 
<form action="." method="post" enctype="multipart/form-data"> 
{{ user form.as p }} 
{{ profile form.as p }} 
{ csrf token 当 } 
<p><input type="submit" value="Save changes"></p> 
</form> 
{s endblock 要 } 


当前 表单 中 包含 了 enctype="multipart/form-data"， 以 启用 文件 上 传 操作 。 此 处 使 用 了 


一 个 HTML 表单 提交 user_form 和 profile_form 表单 。 
注册 新 用 户 并 打开 http://127.0.0.1:8000/account/edit/， 对 应 页 面 如 图 4.16 所 示 。 


Edit your account 


You can edit your account using the following form: 


First name: 


Paloma 


Last name: 
Melé 


Email address: 


paloma@zenxitcom 


Date of birth: 


1981-04-14 


Photo: 


Choose Fie no file selected 


图 4.16 
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当前 ,还 可 编辑 dashboard 页 面 ， 同 时 包含 指向 配置 文件 编辑 以 及 密码 页 面 修改 的 链 
接 。 打 开 account/dashboard.html 模板 ， 并 查看 下 列 代码 行 : 


<p>Welcome to your dashboard.</p> 
并 利用 下 列 代码 行 予 以 蔡 换 : 


<p>Welcome to your dashboard. You can <a href="{% url "edit" %}">edit your 
Profile</a> or <a href="{% url "password change" %}">change your 
Password</a>.</p> 


至 此 ， 用 户 可 访问 表单 并 编辑 其 配置 表单 。 在 浏览 器 中 打开 http://127.0.0.1:8000/ 


account/， 测 试 新 链接 并 编辑 用 户 的 配置 文件 ， 如 图 4.17 所 示 。 
Dashboard 


Welcome to your dashboard. You can 


图 4.17 
Django 还 提供 了 一 种 方式 可 用 自 定义 模型 蔡 换 整个 用 户 模型 。 相 应 地 ， 用 户 类 应 继 
承 自 Django 的 AbstractUser， 并 作为 抽象 模型 提供 了 默认 用 户 的 全 部 实现 。 关 于 这 一 方 
案 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/auth/customizing/#substitutinga- 
custom-user-model 以 了 解 更 多 内 容 。 
使 用 自 定义 用 户 模型 包含 了 更 大 的 灵活 性 ， 但 也 可 能 导致 难以 与 可 插入 的 应 用 程序 
进行 集成 ， 这 些 应 用 程序 与 Django 的 验证 用 户 模 型 实现 交互 。 


4.3.3 ”使 用 消息 框架 


若 用 户 可 与 平台 间 进 行 交互 ， 往 往 需 要 通知 用 户 其 操作 结果 。 对 此 ，Django 包含 了 
一 个 内 置 的 消息 框架 ， 并 可 向 用 户 显示 相关 信息 。 

消息 框架 位 于 django.contrib messages 中 ， 当 利用 python manage.py startproject 创建 
新 项 目 时 , 将 被 包含 在 默认 的 settings.py 文件 的 INSTALLED_APPS 列表 中 。 我 们 将 会 看 
到 ， 设 置 文件 在 MIDDLEWARE 设置 中 涵盖 了 名 为 django.contrib.messages.middleware. 
MessageMiddleware 的 中 间 件 。 

消息 框架 提供 了 一 种 简单 的 方式 可 将 消息 添加 至 用 户 中 。 默 认 状 态 下 ， 消 息 存 储 于 
Cookie 中 (返回 至 会 话 存储 ), 并 在 用 户 执行 的 下 一 次 请 求 中 予以 显示 。 通 过 导入 messages 
模块 ， 并 添加 带 有 快捷 方式 的 新 消息 ， 可 在 视图 中 使 用 消息 框架 ， 如 下 所 示 : 
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from django .contrib import messages 
messages .error (request, 'Something went wrong') 
我 们 可 通过 add_message() 方 法 ， 或 者 下 列 任意 一 种 快捷 方法 创建 新 消息 。 
success(): 操作 成 功 后 ， 将 显示 成 功 消息 。 
info0: 显示 信息 消息 。 
warming(0: 操作 行将 失败 。 
error(): 操作 未 成 功 。 
口 debug0: 在 产品 环境 中 删除 或 忽略 的 调试 消息 。 
下 面 将 向 当前 平台 中 添加 消息 。 消息 框架 以 全 局 方式 应 用 于 项 目 上 ， 因 而 我 们 
可 以 在 基 模 板 中 为 用 户 显示 消息 。 打 开 account 应 用 程序 中 的 base.html 模板 ， 并 在 带 有 
header ID 的 <div> 元 素 和 带 有 content ID 的 <div> 元 素 之 间 添 加 以 下 代码 : 


[回国 辣 几 上 | 


{% if messages %} 
<ul class="messages"> 
{% for message in messages %} 
<1li class="{{ message.tags }}"> 
{{ messagel|safe }} 
<a href="#" class="close">x</a> 
</1i> 
{ endfor %} 
</ul> 
{% endif %} 


消息 框架 包含 了 上 下 文 处 理 器 django.contrib.messages.context_ processors.messages， 
进而 将 messages 变量 添加 至 请 求 上 下 文中 ， 我 们 可 在 项 目 TEMPLATES 设置 的 context_ 
processors 列表 中 对 其 进行 查看 。 此 外 ， 还 可 在 模板 中 使 用 该 变量 ， 并 向 用 户 显示 所 有 的 
现 有 信息 。 

下 面 尝 试 修改 edit 视图 并 使 用 消息 框架 。 对 此 ， 可 编辑 account 应 用 程序 的 views.py 
文件 ， 如 下 所 示 : 


from django.contrib import messages 


@login required 
def edit (request): 
if request.method == 'POST': 
t 
if user form.is valid() and profile form.is valid() : 
user form.save() 
profile form.save() 
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messages.success (request, 'Profile updated '\ 
'successfully') 


else: 
messages.error (request, 'Error updating your profile') 
else: 
user form = UserEditForm(instance=request.user) 
| 


当 用 户 正 确 地 更 新 了 配置 文件 后 ， 我 们 可 添加 一 条 成 功 消息 。 如 果 表 单 中 包含 了 无 
效 数据 ， 则 添加 一 条 错误 消息 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/account/edit/ 并 编辑 配置 文件 。 当 配置 文件 被 成 
功 更 新 后 ， 将 显示 如 图 4.18 所 示 的 消息 。 


Bookmarks My dashboard Images ”People Hello Paloma, Logout 


图 4.18 
若 数据 无 效 ， 例 如 对 于 Date of birth 字段 使 用 了 错误 的 格式 ， 对 应 消息 如 图 4.19 所 示 。 


Bookmarks My dashboard Images ”People 


图 4.19 


关于 消息 框架 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/ref/contrib/ 以 了 解 更 


4.4 ”构建 自 定义 验证 后 端 


Django 可 对 不 同 的 资源 进行 验证 。AUTHENTICATION BACKENDS 设置 中 包含 了 
针对 项 目的 验证 后 端 列表 。 默 认 时 ， 该 设置 如 下 所 示 : 


['django.contrib.auth.backends .ModelBackend'] 


默认 的 AUTHENTICATION_BACKENDS 将 采用 django.contrib.auth 的 用 户 模式 ， 
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在 用 户 和 数据 库 之 间 进 行 验 证 ， 这 适用 于 大 多 数 项 目 场景 。 然 而 ， 我 们 还 可 创建 自 定义 
后 端 ， 并 在 用 户 和 其 他 资源 之 间 进 行 验证 ， 如 LDAP 目录 或 其 他 系统 。 

关于 自 定义 验证 机 制 的 更 多 信息 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/ 
topics/auth/customizing/#other-authentication-sources。 

当 使 用 django.contrib.auth 的 authenticate() 函 数 时 ，Django 将 尝试 将 用 户 与 定义 于 
AUTHENTICATION_BACKENDS 中 的 每 个 后 端 进行 逐一 验证 ， 直 至 其 中 的 某 个 后 端 成 
功 地 验证 了 用 户 。 只 有 全 部 后 端 验证 均 失 效 时 ， 站 点 将 不 会 对 该 用 户 授权 。 

Django 提供 了 一 种 较为 简单 的 方式 定义 自己 的 验证 后 端 。 这 里 ， 验 证 后 端 定义 为 一 
个 类 ， 并 可 提供 以 下 两 个 方法 : 

口 authenticate() 方 法 接收 request 对 象 以 及 用 户 凭 证 作为 参数 ， 同 时 须 返 回 一 个 与 

此 类 和 凭证 相 匹配 的 user 对 象 ( 若 该 凭证 有 效 ) ;否则 返回 None。 此 处 ，request 
对 象 表示 为 一 个 HttpRequest 对 象 ; 若 未 提供 至 authenticate0 中 ,方法 则 返回 None。 

口 ”get_user() 接 收 一 个 用 户 ID 参数 并 返回 一 个 user 对 象 。 

创建 一 个 自 定义 验证 框架 其 简单 程度 类 似 于 编写 一 个 Python 类 ， 且 需要 实现 上 述 两 
个 方法 。 下 面 将 定义 一 个 验证 后 端 ， 并 通过 电子 邮件 地 址 《而 非 其 用 户 名 ) 实现 站 点 内 
的 用 户 验证 。 

下 面 在 account 应 用 程序 目录 中 创建 新 文件 ， 将 其 命名 为 authentication.py 并 添加 下 
列 代码 : 


from django.contrib.auth.models import User 


class EmailAuthBackend (object) : 


mnnm 


Authenticate using an e-mail address . 
mm 
def authenticate (self, request, username=None, password=None): 
try: 
user = User.objects.get (email=username) 
人 user.check password (password): 
return user 
return None 
except User.DoesNotExist: 
return None 


def get userl(self, user id) : 
Ces 
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return User.objects.get (pk=user id) 
except User.DoesNotExist: 
return None 
上 述 代码 定义 了 一 个 简单 的 验证 框架 。 其 中 ，authenticate0 方 法 接收 一 个 request 对 
象 ， 以 及 可 选 参数 username 和 password。 我 们 可 以 选择 不 同 的 参数 ， 但 需 使 用 usermmame 
和 password 确保 当前 后 端 与 验证 框架 视图 直接 协同 工作 。 上 述 代 码 的 工作 方式 解释 如 下 : 
口 ”authenticate() 方 法 。 我 们 尝试 利用 给 定 的 电子 邮件 地 址 检索 用 户 ， 并 通过 用 户 模 
型 的 内 置 check password() 方 法 检测 密码 。 该 方法 处 理 密码 的 哈 希 计算 ， 将 给 定 
密码 与 存储 在 数据 库 中 的 密码 进行 比较 。 
口 get_user() 方 法 。 通 过 设置 于 user id 参数 中 的 ID 获取 一 个 用 户 。Django 使 用 验 
证 用 户 的 后 端 以 在 用 户 会 话 过 程 中 检索 User 对 象 。 
编辑 项 目的 settings.py 文件 并 添加 下 列 设置 内 容 : 
AUTHENTICATION BACKENDS = [ 


'django.contrib.auth.backends .ModelBackend', 
"account .authentication.EmailAuthBackend', 


] 

在 上 述 代码 中 ， 我 们 保留 了 采用 用 户 名 和 密码 进行 身份 验证 的 默认 ModelBackend， 
并 包含 了 基于 电子 邮件 的 身份 验证 后 端 。 下 面 在 浏览 器 中 打开 http://127.0.0.1:8000/ 
account/login/。 注 意 ，Django 尝试 对 每 个 后 端 验证 用 户 身份 ， 因 而 现在 应 可 利用 用 户 名 
或 电子 邮件 地 址 账户 实现 无 颖 登录 。 其 间 ,， 用 户 和 凭证 通过 ModelBackend 验证 后 端 进行 检 
测 。 如 果 未 返回 任何 用 户 ， 用 户 凭证 则 通过 自 定义 的 EmailAuthBackend 后 端 被 检测 。 


@ 注意 ， 
AUTHENTICATION_ BACKENDS 设置 中 列 出 的 后 端 顺序 很 重要 。 如 果 相 同 的 凭证 
对 多 个 后 端 均 为 有 效 ，Dijango 将 在 成 功 验 证 用 户 的 第 一 个 后 端 处 停止 。 


4.5 向 站 点 中 添加 社交 网 站 验证 


我 们 可 能 会 通过 相关 服务 ， 如 Facebook、Twitter 或 Google， 向 站 点 中 添加 社交 网 站 
验证 。Python 中 的 Social Auth 模块 可 简化 向 站 点 中 添加 社交 验证 这 一 处 理 过程 。 通 过 该 
模块 ， 用 户 可 使 用 其 他 服务 的 账户 登录 当前 站 点 。 读 者 可 访问 https://github.com/python- 
social-auth 查看 该 模块 的 代码 。 

针对 不 同 的 Python 框架 ， 该 模块 涵盖 了 相应 的 身份 验证 后 端 ， 包 括 Django。 当 通过 
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pip 安装 Django 数据 包 时 ， 可 打开 控制 台 并 运行 下 列 命 


Pip install social-auth-app-django==2.1.0 


随后 , 在 项 目的 settings.py 文件 中 , 将 social django 添加 至 INSTALLED APPS 设置 
中 ， 如 下 所 示 : 
INSTALLED APPS = [ 


汪汪 
'social django', 


] 

这 是 将 python-social-auth 添加 到 Django 项 目的 默认 应 用 程序 。 接 下 来 运行 下 列 命令 ， 
并 将 python-social-auth 模块 与 数据 库 同步 : 

Python manage.py migrate 

默认 应 用 程序 的 迁移 如 下 所 示 : 

Applying social django.0001 initial... OK 


Applying social django.0002 add related name... OK 


Applying social django.0008 partial timestamp... OK 


Python-social-auth 包含 了 针对 多 种 服务 的 后 端 。 读者 可 访问 https://python-social-auth. 
readthedocs.io/en/latest/backends/index.html#supported-backends 以 查看 全 部 后 端 列表 。 
我 们 将 针对 Facebook、Twitter 以 及 Google 添加 验证 后 端 。 
对 此 ， 需 要 将 社交 网 站 登录 URL 路 径 添加 至 项 目 中 。 打 开 bookmarks 项 目的 urls py 
文件 ， 将 social django URL 路 径 加 入 其 中 ， 如 下 所 示 : 
urlpatterns = [ 
path('admin/', admin.site.urls), 
path('account/', include('account.urls')), 
path('social-auth/', 
include('social django.urls', namespace='social’')), 
] 
在 成 功 验证 后 ， 一 些 社交 服务 并 不 支持 将 用 户 重 定向 至 127.0.0.1 或 localhost。 为 了 
使 社交 验证 能 够 正常 工作 ， 此 处 需要 一 个 域名 。 对 此 ， 在 Linux 或 macOS X 环境 下 ， 编 
辑 /etc/hosts 文件 并 添加 下 列 代 码 行 : 


127.0.0.1 mysite.com 


这 将 通知 计算 机 将 mysite.com 主机 名 指向 自己 的 机 器 。 在 Windows 环境 下 ，hosts 
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文件 位 于 C:\Windows\System32\Drivers\etc\hosts 中 。 


当 验 证 主机 重 定向 是 否 可 正常 工作 时 ， 可 利用 python manage.py runserver 启动 开发 
服务 器 ， 并 在 浏览 器 中 打开 http://mysite.com:8000/account/login/。 此 时 将 会 看 到 如 图 4.20 


所 示 的 错误 提示 。 


图 4.20 


Django 利用 ALLOWED HOSTS 设置 控制 主机 并 为 应 用 程序 提供 服务 ， 这 可 视 作 一 
种 安全 措施 ， 以 避免 HTTP 主机 遭受 攻击 。Django 仅 支 持 该 列表 中 的 主机 进而 为 应 用 程 
序 提 供 服 务 。 关 于 ALLOWED HOSTS 设置 ， 读 者 可 访问 https:// docs.djangoproject.com/ 
en/2.0/ref/settings/#allowed-hosts。 

编辑 项 目 中 的 settings.py 文件 ， 并 按照 下 列 方式 编辑 ALLOWED_HOSTS: 


ALLOWED HOSTS = ['mysite.com', 'localhost', '127.0.0.1'] 


除了 mysite.com 主机 之 外 ， 还 可 显 式 地 包含 localhost 和 127.0.0.1。 据 此 ， 可 通过 
localhost 访问 站 点 。 当 DEBUG 为 Tme 且 ALLOWED HOSTS 为 空 时 ， 这 将 表示 为 默认 
的 Django 行为 。 随 后 可 在 浏览 器 中 打开 http://mysite.com:8000/account/login/。 


4.5.1 基于 Facebook 的 验证 


当 利 用 Facebook 账户 登录 当前 站 点 时 ， 可 在 项 目 settingspy 文件 中 向 
AUTHENTICATION_BACKENDS 添加 下 列 代 码 行 : 
'social core.backends.facebook.FacebookOAuth2', 
为 了 添加 基于 Facebook 的 社交 验证 , 我 们 需要 使 用 到 Facebook 开发 者 账户 ， 并 创建 
-个 新 的 Facebook 应 用 程序 。 对 此 ， 可 在 浏览 器 中 打开 https://developers.facebook.com/ 
apps/， 如 图 4.21 所 示 。 


facebook for developers Products Docs Tools&Support News Videos earc My Apps = 


Search apps by title 


图 4.21 
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sigs 


上 
世 


上 Add a New App 按钮 。 图 4.22 显示 了 对 应 的 表单 并 创建 了 


Create a New App ID 


Get started integrating Facebook into your app or website 


Display Name 


Bookmarks 


Contact Email 


antonio.mele@zenxit.com 


By proceeding, you agree to the Facebook Platform Policies Cancel 


图 4.22 


个 新 的 应 上 


程 


fF ID。 


在 Display Name 文本 框 中 输入 Bookmarks， 输 入 相应 的 电子 邮件 地 址 后 单 击 Create 


Facebook Login 


The world's number one social login 
product. 


Read Docs [setup | 


图 4.23 


户 将 被 询问 选择 相应 的 平台 ， 如 图 4.24 所 示 。 
此 处 选择 Web 平台 ， 对 应 的 表单 如 图 4.25 所 示 。 


App ID 按钮 。 随 后 将 会 看 到 新 应 用 程序 的 控制 面板 ， 并 显示 了 不 同 的 功能 项 ， 进 而 对 应 
用 程序 进行 设置 。 考 察 如 图 4.23 所 示 的 Facebook Login 对 话 框 ， 随 后 单 击 Set Up 按钮 。 


这 里 ， 输 入 http://mysite.com:8000/ 作 为 Site URL 并 单 击 Save 按钮 ， 此 处 可 忽略 快速 


启动 处 理 的 重 置 。 在 菜单 左 侧 ， 单 击 Dashboard 项 ， 如 图 4.26 所 示 。 
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Use the Quickstart to add Facebook Login to your app. To get started, select the platform for this app. 


Other 


图 4.24 


1. Tell Us about Your Website 


Tell us what the URL of your site is. 


Site URL 


http:/mysite.com:8000/ 


图 4.25 


于 sookmarts ApP ID: 1865597340135974 .> View Analytics 攻 Tools&Support Docs Pp 


Se Dashboard 
Alerts Bookmarks 


AppR 
APIVersion App ID 


v210 1865597340135974 


App Secret 


图 4.26 


复制 App ID 和 App Secret， 并 将 其 添加 至 项 目的 settings.py 文件 中 ， 如 下 所 示 ; 


SOCIAL AUTH FACEBOOK KEY = 'XXX' # Facebook APP ID 
SOCIAL AUTH FACEBOOK SECRET = "XXX' # Facebook App Secret 


作为 可 选 内 容 ， 可 以 定义 一 个 SOCIAL AUTH FACEBOOK_SCOPE 设置 ， 并 添加 
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问 Facebook 用 户 请 求 的 额外 权限 ， 如 下 所 示 : 
SOCIAL AUTH FACEBOOK SCOPE = ['email'] 


下 面 返回 至 Facebook 并 单 击 Settings 按钮 。 这 将 显示 一 个 表单 ， 其 中 包含 了 多 项 应 


程序 设置 。 此 处 可 在 App Domains 下 方 添加 mysite.com， 如 图 4.27 所 示 。 


App Domains 


mysite.com 


图 4.27 
单 击 Save Changes 按钮 ， 在 菜单 左 侧 ， 单 击 Facebook Login 按钮 ， 确 保 下 列 设置 处 
于 活动 状态 : 
口 Client OAuth Login。 
口 Web OAuthLogin。 


DD Embedded Browser OAuth Login。 
在 Valid OAuth redirect URIs 下 方 输入 http://mysite.com:8000/social-auth/complete/ 


facebook/， 如 图 4.28 所 示 。 


Client OAuth Settings 
Client OAuth Login 


Web OAuth Login Force Web OAuth Reauthentication 


Use Strict Mode for Redirect URIs 


Embedded Browser OAuth Login 


Valid OAuth redirect URIs 
http://mysite.com:8000/social-auth/complete/facebook/ 


二 | Login from Devices 


图 4.28 


打开 account 应 用 程序 的 registration/login html 模板 ， 并 在 content 块 下 方 添 加 下 列 代码 : 
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<div class="social"> 
<ul> 
<1i class="facebook"><a href="{% Url "social:begin" "facebook" $}"> 


Sign in with Facebook</a></1i> 
<Aal> 
</div> 


在 浏览 器 中 打开 http:/mysite.com:8000/accountlogin/， 图 4.29 显示 了 相应 的 登录 页 面 。 


Bookmoarks 


Log-in 


Please, use the following form to log-in. If you don't have an account reg'sier here 


Username: Sign in with Facebook 


Password: 


Forgotten your password? 


图 4.29 


单 击 Sign in with Facebook 按钮 ， 用 户 将 被 向 至 Facebook。 随 后 将 显示 一 个 模式 
对 话 框 并 请 求 授予 权限 ， 以 使 Bookmarks 应 用 程序 可 访问 用 户 的 Facebook 公开 信息 ， 如 


图 4.30 所 示 。 


Bookmarks will receive: 
your public profile and email address. © 


加 Edit This 
Continue as Antonio 


图 4.30 
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单 击 Continue as Antonio 按钮 , 用 户 登 录 后 将 被 重 定 向 至 站 点 的 配置 面板 页 面 。 回忆 
一 下 , 我 们 曾经 在 LOGIN_REDIRECT_URL 中 设置 了 这 一 URL。 不 难 发 现 ， 向 站 点 添加 
社交 网 站 验证 其 操作 过 程 较为 直观 。 


4.5.2 ”基于 Twitter 的 验证 


对 于 基于 Twitter 的 社交 验证 ， 可 向 项 目 settings.py 文件 的 AUTHENTICATION 
BACKENDS 设置 中 添加 下 列 代码 行 : 

"social_core.backends .twitter .TwitterORAuth'"， 

用 户 需 要 在 Twitter 账号 中 创建 一 个 新 的 应 用 程序 。 对 此 ， 在 浏览 器 中 打开 
https://apps.twitter.com/app/new， 将 显示 如 图 4.31 所 示 的 表单 。 


Application Details 


Bookmarks 


Description * 


Test Django application. 


Website * 


http://mysite,com:8000/ 


Callback URL 
http;//mysite.com:8000/social-auth/complete/twitter/ 


图 4.31 

随后 输入 当前 应 用 程序 的 细节 信息 ， 其 中 包括 以 下 方面 。 

DD Website: http://mysite.com:8000/。 

口 Callback URL: http://mysite.com:8000/social-auth/complete/twitter/。 

接 下 来 ， 单 击 Create your Twitter application 项 ， 这 将 显示 应 用 程序 的 详细 信息 。 选 
择 Keys and Access Tokens 选项 卡 ， 对 应 信息 如 图 4.32 所 示 。 

下 面 将 Consumer Key 和 Consumer Secret 复制 至 项 目 settings.py 文件 中 的 设置 项 中 ， 
如 下 所 示 : 


“124。 Django 项 目 实例 精 解 (第 2 版 


SOCIAL AUTH TWITTER KEY = "XXX'" # Twitter Consumer Key 
SOCIAL AUTH TWITTER SECRET = 'XXX' # Twitter Consumer Secret 


Bookmarks 


Details Settings Keys and Access Tokens Permissions 


Application Settings 


Consumer Key (API Key) 。 eJJU1AzzEQFJ6PAgqLic18TH1 


Consumer Secret (API 
Secret) 


Access Level Read and write (modify app permissions) 


图 4.32 
编辑 registration/login.html 模板 ， 并 向 <ul> 元 素 中 添加 下 列 代码 : 
<li class="twitter"><a href="{% url "social:begin" "twitter" 
%$}">Login with Twitter</a></1i> 
在 浏览 器 中 打开 http://mysite.com:8000/account/login/ 并 单 击 Login with Twitter 链接 。 
用 户 将 被 重 定向 至 Twitter， 并 被 询问 验证 应 用 程序 ， 如 图 4.33 所 示 。 


Authorize Bookmarks Test to use 


our account? 
y seh 


PP Bookmarks 
Authorize app Cancel a 


This application will be able to: 


» Read Tweets from your timeline. 


。 See who you folow. 


Will not be able to: 
。 Follow new people 
» Update your profile. 
Post Tweets for you. 
Access your direct messages， 
See your email address， 
See your Twitter password 


图 4.33 


可 
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下 


单 击 Authorize app 按钮 ， 用 户 登录 后 将 被 


4.5.3 基于 Google 的 验证 


定向 至 站 点 的 配置 页 面 。 


Google 提供 了 OAnuth2 验证 ， 读 者 可 访问 https://developers.google.com/identity/protocols/ 
OAuth2 以 了 解 Google 的 OAuth2 实现 。 

当 采 用 Google 实现 身份 验证 时 ， 可 向 项 目 settings.py 文件 的 AUTHENTICATION_ 
BACKENDS 设置 中 添加 下 列 代码 行 : 


'social core.backends.google.GoogleOAuth2', 


首先 需要 在 Google Developer Console 中 生成 API 密 钥 。 在 浏览 器 中 打开 https://console. 
developers.google.com/apis/， 单 击 Select a project 并 创建 新 的 项 目 ， 如 图 4.34 所 示 。 


三 Google APls 


New Project 


加 Youhave12 projects remaining in your quota. Learn more. 


Project name 


Bookmarks 


Your project ID will be bookmarks-185117 Edit 


Ex 


图 4.34 


待 项 目 创建 完毕 后 ， 在 Credentials 下 方 单 击 Create credentials 按钮 ， 并 选择 OAuth 
client ID， 如 图 4.35 所 示 。 

此 时 ，Google 首先 将 询问 相关 配置 信息 ， 如 图 4.36 所 示 。 

上 述 许可 页 面 表示 用 户 可 利用 Google 账户 访问 当前 站 点 。 单 击 Configure consent 
screen 按钮 ， 输 入 电子 邮件 地 址 ， 在 Product name 下 方 输入 Bookmarks， 并 单 击 Save 按 
钮 。 至 此 ， 应 用 程序 许可 页 面 配置 完毕 ， 用 户 将 被 重 定 向 并 结束 客户 端 ID 的 创建 过 程 。 
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APls 
Credentials 


You need credentials to access APls. Enable the APls that you 
planto use and then create the credentials that they require. 
Depending on the APl, you need an API key, a service account or 
an OAuth 2.0 client ID. Refer to the API documentation for details. 


Create credentials ~ 


APl key 
ldentifies your project using a simple API key to check quota and access. 


OAuth client ID 
Requests user consent so your app can access the user's data 


Service account key 
Enables server-to-server, app-level authentication using robot accounts. 


Help me choose 
Asks a few questions to help you decide which type of credential to use 


图 4.35 


To create an OAuth client ID, you must first set a product name on the consent screen. Configure consent screen 


图 4.36 

利用 下 列 信息 填写 表单 。 

口 ”Application type: 选择 Web application 。 

口 Name: 输入 Bookmarks。 

口 ” Authorized redirect URIs: 添加 http://mysite.com:8000/social-auth/complete/google- 

oauth2/。 

最 终 表 单 如 图 4.37 所 示 。 

单 击 Create 按钮 ， 将 会 得 到 Client ID 和 Client Secret 密 钥 ， 将 其 添加 至 settings.py 
文件 中 ， 如 下 所 示 : 


SOCIAL AUTH GOOGLE OAUTH2 KEY = "XXX'" # Google Consumer Key 
SOCIAL AUTH GOOGLE OAUTH2 SECRET = "XXX" # Google Consumer Secret 


d 
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Application type 

® Web application 
Android Learn more 
Chrome App Learn more 
iOS Leam more 
PlayStation 4 
Other 


Name 


Bookmarks 


Restrictions 
Enter JavaScript origins, redirect URIs or both 


Authorised JavaScript origins 


For use with requests from a browser. This is the origin URI of the client application. It cannot contain a wildcard 
(https://*.example.com) or a path (https://example.com/subdir). If you're using a non-standard port, you must 
include it in the origin URI 


nttp 
Authorised redirect URIs 
For use with requests from a web server This is the path in your application that users are redirected to after they 


have authenticated with Google. The path will be appended with the authorisation code for access. Must hayea 
protocol. Cannot contain URL fragments or relative paths. Cannot be a public IP address. 


http://mysite.com:8000/social-auth/complete/google-oauth2/ 


https://www.example com/oauth2callback 


Cancel 


图 4.37 


在 Google Developers Console 的 左 侧 菜 单 中 ， 在 APIs & Services 下 方 单 击 Library 链 
接 ， 将 会 看 到 包含 全 部 Google API 的 一 个 列表 。 单 击 Google+ API 按钮 并 于 随后 单 击 
ENABLE 按钮 ， 如 图 4.38 所 示 。 


Google+ API 
Google 


The Google+ APl enables developers to build on top of the Google+ 
platform 


myrshn © 


图 4.38 


编辑 login.html 模板 ， 并 向 <ul> 元 素 中 添加 下 列 代码 : 


<li class="google"><a href="{% url "social:begin" 
"google-oauth2" $}">Login with Google</a></1i> 
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如 图 4.39 所 示 。 


在 浏览 器 中 打开 http://mysite.com:8000/account/login/， 对 应 的 登录 页 


Bookmarks 


Log-in 


Please, use the following form to log-in. If you don't have an account register here 


Username: Sign in with Facebook 


Password: 
Login with Google 


图 4.39 
单 击 Login with Google 按钮 ， 用 户 登 录 后 将 被 重 定向 至 站 点 的 配置 页 面 。 
至 此 ， 社 交 验 证 已 被 加 入 至 站 点 中 ， 此 外 ， 还 可 以 使 用 Python social Auth 与 其 他 流 
行 的 在 线 服务 轻松 地 实现 社交 身份 验证 。 


4.6 本 章 小 结 


本 章 讨论 了 如 何在 站 点 中 构建 社交 验证 ， 以 及 如 何 创建 自 定义 用 户 配置 文件 。 除 此 
之 外 ， 我 们 还 向 站 点 中 添加 了 社交 验证 机 制 。 
第 6 章 将 学 习 如 何 创建 图 像 书签 系统 、 图 像 缩 略 图 ， 并 构建 AJAX 视图 。 


第 5 章 共享 网 站 中 的 内 容 


第 4 章 在 站 点 中 创建 了 用 户 注册 和 验证 系统 ， 同 时 还 学 习 了 如 何 针对 用 户 创建 自 定 
义 配 置 模型 ， 并 通过 主要 的 社交 网 络 将 社交 验证 添加 至 站 点 中 。 
本 章 将 学 习 如 何 创建 JavaScript 书签 工具 ， 并 将 其 他 站 点 中 的 内 容 分 享 至 当前 网 站 
中 。 此 外 ， 还 将 通过 jQuery 和 Dijango 在 项 目 中 实现 AJAX 功能 
本 章 主要 涉及 以 下 内 容 
创建 多 对 多 关系 。 
自 定义 表单 行为 。 
与 Django 协同 使 用 jQuery。 
构建 jQuery 书签 工具 。 
利用 sorl-thumbnail 生成 图 像 缩 略图 。 
实现 AJAX 视图 并 将 其 与 jQuery 集成 。 
针对 视图 实现 自 定义 装饰 器 。 
构建 AJAX 分 页 机 制 。 


5.1 构建 图 像 书签 网 站 


加 加 上 回迁 回避 


本 节 将 讨论 源 自 其 他 网 站 和 本 站 点 的 图 像 标签 工具 以 及 共享 行为 。 对 此 ， 我 们 需要 
执行 以 下 任务 : 

(1) 定义 一 个 模型 以 共享 图 像 及 其 信息 。 

(2) 创建 一 个 表单 和 视图 ， 并 处 理 图 像 上 传 操作 。 

(3) 构建 一 个 用 户 系统 ， 并 可 发 布 源 自 外 部 网 站 的 图 像 。 

首先 ， 可 利用 下 列 命令 在 bookmarks 项 目 中 创建 一 个 新 的 应 用 程序 : 


django-admin startapp images 


在 settings.py 文件 中 向 INSTALLED APPS 设置 中 添加 新 的 应 用 程序 ， 如 下 所 示 : 


INSTALLED APPS = [ 
i 
'images .apps. ImagesConfig', 


。130 Django 项 目 实例 精 解 〈 第 2 版 
至 此 ， 我 们 在 当前 项 目 中 激活 了 iamges 应 用 程序 。 
5.1.1 构建 图 像 模型 
编辑 images 应 用 程序 的 models.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.db import models 
from django.conf import settings 


class Image (models.Model): 
user = models.ForeignKey (settings.AUTH USER MODEL, 
related name='images created', 
on delete=models .CASCADE) 
title = models.CharField (max length=200) 
slug = models.SlugField (max length=200, 
blank=True) 
url = models .URLField() 
image = models.ImageField (upload to='images/%Y/%m/%d/') 
description = models.TextField (blank=True) 
created = models.DateField(auto now add=True, 
db index=True) 


def sate "(Seueys 
return self.title 


上 述 代 码 表示 为 所 将 使 用 的 模型 ， 并 用 于 存储 源 自 不 同 网 站 的 图 像 ， 下 面 考察 该 模 


型 中 的 各 个 字段 : 


口 user 表示 设 定 图 像 书签 的 User 对 象 ， 并 定义 为 一 个 外 键 字段 一 一 些 处 定义 了 一 
个 一 对 多 关系 。 用 户 可 发 布 多 个 图 像 ， 但 每 幅 图 像 由 单一 用 户 所 发 布 。 针 对 


on _delete 参数 ， 我 们 使 用 CASCADE。 当 用 户 被 删除 时 ， 相 关 图 像 也 将 
口 title 表示 图 像 的 标题 。 


被 删除 。 


口 slug 表示 一 个 简短 的 标题 ， 仅 包含 字母 、 数 字 、 下 画 线 或 者 连 字符 ， 月 


于 构建 


SEO 友好 的 URL。 

url 表示 图 像 的 原始 URL。 

iamge 表示 图 像 文件 。 

description 表示 可 选 的 图 像 描述 。 


DODODD 


created 表示 对 象 在 数据 库 中 创建 的 日 期 和 时 间 。 由 于 使 用 了 auto_now_add， 


而 当 对 象 被 创建 时 , 对 应 日 期 将 被 自动 设置 .此 外 ,我 们 还 使 用 了 db_index=True， 


以 使 Django 针对 该 字段 在 数据 库 中 生成 一 个 索引 。 
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Oa. 

数据 库 索 引 可 有 效 地 改进 查询 性 能 ,对 此 ,可 为 经 常 使 用 filter()、exclude() 或 order_by() 
查询 的 字段 设置 db_index=True。ForeignKey 字段 或 包含 unique=True 的 字段 表示 索引 的 
创建 行为 。 除 此 之 外 ， 还 可 使 用 Meta.index _ together 针对 多 个 字段 创建 索引 。 


我 们 将 覆 写 Image 模型 的 save() 方 法 ， 并 根据 title 字段 值 自 动 生 成 sug 字段 。 导 入 
slugify0 并 向 Image 模型 中 添加 save() 方 法 ， 如 下 所 示 : 


from django .utils .text import slugify 


class Image (models.Model): 
有 
def savel(self, *args, **kwargs): 
if not self.slug: 
self.slug = slugify(self.title) 
super (Image, self) .save(*args, **kwargs) 
在 上 述 代码 中 ， 若 未 提供 slug， 可 使 用 Django 提供 的 slugify0 函 数 针对 给 定 的 标题 
自动 生成 图 像 slug, 随后 即 可 保存 该 对 象 。 我 们 将 针对 图 像 采 用 自动 方式 生成 slug， 以 使 
用 户 无 须 采用 手工 方式 针对 每 幅 图 像 输 入 slug。 


5.1.2 ”生成 多 对 多 关系 


这 里 将 向 Image 模型 中 加 入 了 一 个 字段 ， 并 存储 对 某 幅 图 像 感 兴趣 的 用 户 。 此 时 需 
要 使 用 到 多 对 多 关系 ， 其 原因 在 于 ， 某 个 用 户 可 能 会 对 多 幅 图 像 感 兴趣 ， 而 每 幅 图 像 也 
可 能 受到 多 位 用 户 的 青睐 。 
对 此 ， 可 向 Image 模型 中 添加 下 列 字 有 段 : 
users like = models.ManyToManyField(settings.AUTH USER MODEL, 
related name='images liked', 
blank=True) 
当 定义 ManyToManyField 时 , Django 通过 两 个 模型 的 主键 创建 中 间 连 接 表 。 相 应 地 ， 
ManyToManyField 可 定义 于 两 个 相关 模型 中 。 
类 似 于 ForeignKey 字段 ，ManyToManyField 的 related_name 属性 允许 我 们 将 相关 对 象 
的 关系 命名 回 这 个 对 象 。ManyToManyField 字段 提供 了 一 个 多 对 多 管理 器 ， 从 而 可 检索 相 
关联 的 对 象 ， 如 image.users_like.all0; 或 者 从 user 对 象 ， 如 user.images_like.all0 中 检索 。 
打开 命令 行 并 运行 下 列 命令 创建 初始 迁移 : 


Python manage.py makemigrations images 
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对 应 输出 结果 如 下 所 示 : 


Migrations for 'images': 
images/migrations/0001 initial.py 
- Create model Image 


运行 下 列 命 令 并 使 迁移 生效 : 

Python manage.py migrate images 

对 应 输出 结果 如 下 所 示 : 

Applying images.0001 initial... OK 


当前 ，Image 与 数据 库 同步 。 
5.1.3 ”在 管理 站 点 中 注册 图 像 模型 


编辑 images 应 用 程序 的 admin.py 文件 ,并 将 Image 模型 注册 至 管理 站 点 中 ,如 下 所 示 : 


from django.contrib import admin 
from .models import Image 


@admin.register (Image) 
class ImageAdmin (admin .ModelAdmin): 


list display = ['title', 'slug', 'image', 'created'] 


list filter = ['created'] 


利用 python manage.py runserver 命令 启动 开发 服务 器 ， 并 在 浏览 器 中 打开 http://127.0.0.1: 


8000/admin/， 将 会 看 到 管理 站 点 中 的 Image 模型 ， 如 图 5.1 所 示 。 


Images 十 Add Change 


图 5 


5.2 发 布 其 他 站 点 中 的 内 容 


lj 户 应 可 对 源 自 外 部 站 点 的 图 像 设置 书签 。 相应 地 , 用 户 将 提供 该 图 像 的 URL/biaoti 


以 及 可 选 的 描述 内 容 。 对 应 应 用 程序 将 下 载 该 图 像 并 在 数据 库 中 生成 新 的 Image 对 象 。 


面 开始 构建 一 个 表单 并 提交 新 的 图 像 。 对 此 ， 可 在 Images 应 上 


程 


这 目 录 下 


P 创 建新 
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文件 forms.py， 并 添加 下 列 代 码 : 


from django import forms 
from .models import Image 


class ImageCreateForm(forms.ModelForm): 
class Meta: 
model = Image 
fields = ('title', 'url', 'description') 
widgets = { 
'url': forms.HiddenInput, 
} 


在 上 述 代码 中 可 以 看 到 ， 该 表单 为 构建 于 Image 模型 的 ModelForm 表单 ， 且 仅 包含 
title、url 和 description 字段 。 用 户 不 会 在 该 表单 中 直接 输入 图 像 URL。 相 反 ， 我 们 将 利 
用 JavaScript 工具 予以 提供 ， 并 从 外 部 站 点 中 选择 一 幅 图 像 ， 对 应 表单 将 作为 参数 接收 其 
URL。 这 里 将 覆 写 默认 的 ul 字段 的 微 件 ， 以 使 用 HiddenInput 微 件 。 该 微 件 基 于 
type="hidden" 属 性 显示 为 HTML input 元 素 。 使 用 这 一 字段 的 主要 原因 是 : 我 们 并 不 需要 
该 字段 对 用 户 可 见 。 


5.2.1 清空 表单 字段 


为 了 验证 所 提供 的 图 像 URL 有 效 ， 需 要 检测 文件 名 是 否 以 jpg 或 jrpg 扩展 名 结尾 ， 且 
仅 支 持 JPEG 文件 。 在 第 4 章 中 曾 讨论 了 Django 可 定义 表单 方法 , 并 利用 clean_<fieldname>() 
标记 清空 特定 的 字段 。 如 果 在 表单 实例 上 调用 is_valid0， 则 对 每 个 字段 执行 此 方法 。 在 
清空 方法 中 ， 可 修改 字段 值 或 者 在 必要 时 针对 特定 字段 抛 出 验证 错误 。 对 此 ， 可 向 
ImageCreateForm 添加 下 列 方法 : 


def clean Url(self) : 
url = self.cleaned data['url'] 
valid extensions = ['jpg', 'jpeg'] 
extension = url.rsplit('.', 1) [1].lower() 
if extension not in valid extensions : 
raise forms .ValidationError ('"The given URL does not ' \ 
”match valid image extensions.') 
return url 


上 述 代 码 定 义 了 clean_url() 方 法 并 清空 url 字段 ， 其 工作 方式 如 下 所 示 : 
(1) 通过 访问 表单 实例 的 目录 ， 可 获得 url 字段 值 。 
(2) 解析 URL 并 获得 文件 扩展 名 ， 并 检测 是 否 为 有 效 的 扩展 名 。 若 扩展 名 无 效 ， 
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则 抛 出 ValidationError, 且 表 单 实例 不 会 被 验证 。 此 处 , 我 们 采用 了 较为 简单 的 验证 操作 。 
然 , 读者 也 可 尝试 更 为 高 级 的 方法 , 进而 检查 给 定 的 URL 是 否 提供 了 有 效 的 图 像 文件 。 

除了 验证 给 定 的 URL 之 外 ， 还 需 下 载 图 像 文 件 并 对 其 予以 保存 。 例 如 ， 可 采用 视图 
处 理 表单 以 下 载 图 像 文 件 。 相反 ,还 可 通过 禾 写 模型 表单 的 save0 方 法 实现 更 为 通用 的 做 
法 ， 以 在 每 次 保存 表单 时 执行 该 项 任务 。 


Lk 


5.2.2 ” 覆 写 ModelForm 的 save() 方 法 


ModelForm 提供 了 save() 方 法 将 当前 模型 实例 保存 至 数据 库 中 并 返回 该 对 象 。 该 方法 
接收 一 个 commit 布尔 型 参数 ， 并 指定 该 对 象 是 否 持久 化 至 数据 库 中 。 如 果 commit 表示 
为 False，save() 方 法 将 返回 一 个 模型 实例 ， 但 并 不 会 将 其 保存 至 数据 库 中 。 这 里 ， 我 们 将 
履 写 当前 表单 的 save( 方 法 ， 以 检索 给 定 图 像 并 将 其 保存 。 

在 forms.py 文件 开始 处 加 入 下 列 导入 语句 : 

from urllib import request 


from django.core.files.base import ContentFile 
from django.utils.text import slugify 


随后 ， 向 ImageCreateForm 表单 添加 下 列 save0) 方 法 : 


def save (self，force insert=False, 
force update=False, 
commit=True): 
image = super (ImageCreateForm, self) .save (commit=False) 
image url = self.cleaned data['url'] 
image name = '{}.{}'.format (slugify (image.title), 
image url.rsplit('.', 1)[1].1lower()) 


# download image from the given URL 

response = request.urlopen (image url) 

image.image.save (image_name, 
ContentFile (response.read())， 
save=False) 

if commit: 

image.save () 
return image 


此 处 覆 写 了 save0 方 法 ， 同 时 保留 了 ModelForm 所 需 的 参数 。 上 述 代码 解释 如 下 : 
口 ” 通 过 调用 表单 的 save0 方 法 (commit=False〉， 创 建 了 新 的 image 实例 。 
口 ”从 表单 的 cleaned_data 目录 中 获取 URL。 
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口 将 image 标题 的 slug 与 原始 文件 扩展 名 进行 整合 ， 生 成 图 像 名 称 。 

口 ” 使 用 Python urllib 模块 下 载 图 像 ， 并 于 随后 调用 图 像 字段 的 save( 方 法 ， 同 时 向 

其 传递 一 个 利用 下 载 图 像 内 容 实例 化 的 ContentFile 对 象 。 通 过 这 一 方式 ， 可 将 
该 文件 保存 至 项 目的 media 目录 中 。 除 此 之 外 ， 我 们 还 传递 了 save=False 参数 ， 
以 避免 将 对 象 保存 至 数据 库 中 。 

口 “ 为 了 保持 与 所 履 写 的 save() 方 法 相 一 致 的 行为 , 仅 当 commit 参数 为 True 时 , 方 
可 将 表单 保存 至 数据 库 中 。 

接 下 来 ， 需 要 一 个 视图 用 以 处 理 当前 表单 。 对 此 ， 编 辑 image 应 用 程序 的 views.py 


文件 并 添加 下 列 代码 : 


from django.shortcuts import render, redirect 

from django.contrib.auth.decorators import login required 
from django.contrib import messages 

from .forms import ImageCreateForm 


@login required 
def image create (request) : 
if request.method == 'POST': 
# form is sent 
form = ImageCreateForm(data=request .POST) 
if form.is valid() : 
# form data is valid 
cd = form.cleaned data 
new item = form.save (commit=False) 


# assign current user to the item 

new item.user = request.user 

new item.save () 

messages.success (request， 'Image added successfully') 


# redirect to new created item detail view 
return redirect (new item.get absolute url()) 
Slses 
# build form with data provided by the bookmarklet via GET 
form = ImageCreateForm(data=request .GET) 


return render (request, 
'images/image/create.html', 
{'section': 'images', 
‘form': form}) 
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向 image_create 视图 添加 了 login required 装饰 器 ， 以 防止 未 验证 
图 的 工作 方式 如 下 所 示 : 


口 三 尖 
当 胆 


户 的 访问 行 


期 望 通过 GET 获取 初始 数据 ， 进 而 生成 一 个 表单 实例 。 该 数据 由 源 


外 部 站 点 


目前 ， 假 设 此 类 数据 在 初始 状态 下 即 存在 。 


图 像 的 yrl 和 title 属性 构成 , 并 通过 GET 予以 提供 ( 稍 后 将 讨论 JavaScript 工具 )。 


口 “如果 该 表单 被 提交 ， 将 对 其 有 效 性 进行 检测 。 若 表单 数据 有 效 ， 可 创建 一 个 新 
内 Image 实例 。 通 过 将 commit=False 传递 至 表单 的 save() 方 法 中 ， 该 对 象 不 会 
存储 至 数据 库 中 。 

口 ”将 当前 用 户 赋予 新 的 image 对象 中 。 据 此 ， 可 了 解 到 上 传 每 幅 图 像 的 相关 用 户 。 

口 将 image 对 象 保存 至 数据 库 中 。 

口 最 后 ， 通 过 Django 消息 框架 生成 一 条 成 功 消 息 ， 并 将 用 户 重 定向 至 新 图 像 的 标 


准 URL 处 。 当 前 尚未 实现 Image 模型 的 get_absolute url(0) 方 法 ， 稍 后 将 对 此 加 


下 面 在 images 应 用 程序 中 创建 新 的 urls.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.urls import path 
from . import views 


app name = 'images' 
urlpatterns = [ 


path('create/', views.image create, name='create'), 


] 


接 下 来 编辑 bookmarks 项 目的 urls.py 主 文 件 ， 并 包含 images 应 用 程序 的 路 径 ， 如 下 


所 示 : 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('account/', include('account.urls')), 
path('social-auth/', 
include('social django.urls', namespace='social')), 
path('images/', include('images.urls', namespace='images') 


最 后 ， 还 需 创建 一 个 模板 以 显示 表单 。 对 此 ， 可 在 images 应 用 程序 目录 
目录 结构 : 
templates/ 
images/ 


)， 


ph 创建 下 列 
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image/ 
Create .html 


编辑 create html 模板 并 向 其 中 添加 下 列 代码 : 


{$$ extends "base.htm1l" $%} 


{% block title %$}Bookmark an image{% endblock %} 


{% block content %} 
<hl>Bookmark an image</h1l> 
<img src="{{ request.GET.url }}" class="image-preview"> 
<form action="." method="post"> 
{{ form.as p }} 
{$$ csrf token %} 


<input type="submit" value="Bookmark it!"> 
</form> 
{$$ endblock $} 


在 浏览 器 中 打开 http://127.0.0.1:8000/images/create/?title=...&url=...， 其 中 包含 了 title 
和 url GET 参数 。 后 者 提供 了 已 有 的 JPEG 图 像 URL。 

作为 示例 ， 用 户 可 尝试 使 用 下 列 URL: 

http://127.0.0.1:8000/images/create/?title=%20Django%20and%20Duke&url=http://uploa 


d.wikimedia.org/wikipedia/commons/8/85/Django_Reinhardt and Duke Ellington %28Gottli 
eb%29.jpg. 


包含 图 像 预 览 的 表单 如 图 5.2 所 示 。 


Images 


Bookmark an image 


Tite 


Diango and Duke 


Description: 
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添加 描述 内 容 后 可 单 击 BOOKMARK IT! 按 钮 。 随 后 ， 新 的 Image 对 象 将 被 保存 至 数 
据 库 中 。 然而, 此 处 将 会 得 到 一 条 消息 , 表明 Image 模型 尚未 定义 get_absolute_url() 方 法 ， 


如 图 5.3 所 示 。 
AttributeError at /images/create/ 
"Image' object has no attribute 'get_absolute_url' 
图 5.3 


读者 不 必 对 此 感到 惊慌 , 稍 后 将 会 添加 该 方法 。 在 浏览 器 中 打开 http://127.0.0.1:8000/ 
admin/images/image/， 并 验证 新 的 image 对 象 是 否 已 被 保存 ， 如 图 5.4 所 示 。 


SLUG IMAGE CREATED 


Django and django-and- images/2017/11/05/django-and- Dec. 16, 2017 
Duke duke duke.jpg 


图 5.4 
5.2.3 利用 jQuery 构建 书签 工具 


书签 工具 表示 为 一 个 存储 于 Web 浏览 器 中 的 书签 ， 其 中 包含 了 JavaScript 代码 并 可 
扩展 浏览 器 的 功能 。 当 单 击 书签 时 ，JavaScript 代码 将 在 站 点 中 被 执行 ， 同时 显示 于 浏览 
器 中 。 这 对 于 构建 与 其 他 网 站 交互 的 工具 非常 有 用 。 
一 些 在 线 服务 ， 如 Pinterest， 实 现 了 自己 的 书签 工具 , 用户 可 将 其 他 站 点 的 内 容 分 享 
至 当前 平台 上 。 下 面 将 以 类 似 的 方式 创建 一 个 书签 工具 ， 以 使 用 户 可 在 当前 站 点 上 共享 
其 他 网 站 中 的 内 容 。 
我 们 将 使 用 jQuery 构建 书签 工具 。jQuery 是 一 个 较为 流行 的 JavaScript 框架 ， 可 快 
速 开发 客户 端 中 的 各 项 功能 。 读 者 可 访问 jQuery 的 官方 网 站 ， 以 了 解 与 其 相关 的 更 多 内 
容 ， 对 应 网 址 为 https://jquery.com/。 

下 列 步 又 展示 了 如 何 将 书签 工具 添加 至 浏览 器 中 并 对 其 加 以 使 用 : 

(1) 用 户 将 站 点 中 的 链接 拖 忠 至 浏览 器 的 书签 工具 中 ,该 链接 包含 了 其 href 属性 中 
的 JavaScript 代码 ， 对 应 代码 存储 于 书签 工具 中 。 

(2) 用 户 浏览 至 其 他 站 点 并 单 击 该 书签 工具 后 ， 该 书签 工具 的 对 应 代码 将 被 执行 。 

鉴于 JavaScript 代码 将 作为 书签 工具 被 存储 ， 因而 后 续 操作 将 无 法 对 其 进行 更 新 。 这 
可 视 为 一 种 严重 的 缺陷 ， 针 对 这 一 问题 ， 可 实现 一 个 启动 脚本 ， 并 从 URL 中 加 载 实际 的 


这 
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JavaScript 书签 工具 。 用 户 可 将 这 一 启动 脚本 存储 为 一 个 书签 ， 并 可 在 任意 时 刻 更 新 书签 
工具 代码 。 稍 后 ， 我 们 将 采用 这 一 方案 构建 书签 工具 。 

在 images/templates/ 中 创建 新 的 模板 ， 将 其 命名 为 bookmarklet launcher.js 并 可 视 为 
当前 的 启动 脚本 。 向 该 文件 中 添加 下 列 JavaScript 代码 : 

(function(){ 


if (window.myBookmarklet !== undefined){ 
myBookmarklet (); 


村 

else { 
document .body.appendchild (document .createElement ('script')).src='http: 
//127.0.0.1:8000/static/js/bookmarklet .js?r='+Math.floor (Math.random() 
EEEELERSE EL 


} 
3 


通过 检测 是 否定 义 了 myBookmarklet 变量 ， 上 述 脚 本 将 判断 书签 工具 是 否 已 被 加 载 。 
据 此 ， 当 用 户 重复 单 击 书 签 工 具 时 ， 可 避免 对 其 进行 重复 加 载 。 如 果 myBookmarklet 未 
定义 ， 则 向 对 其 文档 中 加 入 另 一 个 <script> 元 素 ， 从 而 加 载 了 一 个 JavaScript 文件 。 该 脚 
本 标签 通过 随机 数 作为 参数 加 载 bookmarkletjs 脚本 ， 以 防止 从 浏览 器 缓存 中 加 载 文件 。 

实际 的 书签 工具 代码 位 于 bookmarkletjs 静态 文件 中 ， 这 将 允许 我 们 更 新 书签 工具 代 
码 ， 用 户 无 须 更 新 之 前 添加 到 浏览 器 中 的 书签 。 下 面向 配置 页 面 中 添加 书签 工具 启动 程 
序 ， 用 户 可 将 其 复制 至 其 书签 工具 中 。 

编辑 account 应 用 程序 的 account/dashboard.html 模板 ， 如 下 所 示 : 


{s extends "base.htm]l™" $%} 
{% block title %}Dashboard{% endblock %} 


{% block content %} 
<hl>Dashboard</h1l> 


{% with total images created=request.user.images created.count %} 
<p>Welcome to your dashboard. You have bookmarked {{ 
total images created }} image{{ total images created|pluralize }}.</p> 
{% endwith %} 


<p>Drag the following button to your bookmarks toolbar to bookmark images 
from other websites — <a href="javascript:{% include 
"bookmarklet launcher.js" %}" class="button">Bookmark it</a><p> 
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<p>You can also <a href="{% url "edit" %}">edit your profile</a> or <a 

href="{% url "password change" %}">change your password</a>.<p> 

{SS endblock 要 } 

配置 结果 显示 了 用 户 作为 书签 的 全 部 图 像 数 量 。 此 处 使 用 了 {% with %} 标 签 设置 一 
个 变量 ， 该 变量 包含 当前 用 户 标 记 的 图 像 总 数 。 此 外 ， 我 们 还 设置 了 一 个 包含 href 属性 
的 链接 , 其 中 包含 了 书签 工具 启动 脚本 。 同时 , 我 们 还 将 包含 源 自 bookmarklet_launcher.js 
模板 的 JavaScript 代码 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/account/， 将 会 看 到 如 图 5.5 所 示 的 页 面 。 


Bookmarks 


Dashboard 


Welcome to your dashboard. You have bookmarked 1 image. 
Drag the following button to your bookmarks toolbar to bookmark images from other websites 一 9 0 0 


You can also edit your profile or change your password. 


图 5.5 
接 下 来 ， 在 images 应 用 程序 目录 中 创建 下 列 目录 和 文件 : 
static/ 
js/ 


bookmarklet.js 


在 本 章 附带 的 代码 中 ,将 会 在 images 应 用 程序 目录 下 找到 一 个 static/css/ 目 录 。 将 css/ 
目录 复制 到 当前 代码 的 static/ 目 录 下 。 其 中 ，css/bookmarklet.css 文件 提供 了 JavaScript 书 


签 工 具 的 样式 。 
编辑 bookmarkletjs 静态 文件 ， 并 向 其 中 添加 下 列 JavaScript 代码 : 


(function(){ 
Var jquery version = '3.3.1'; 
var site Url = 'http://127.0.0.1:8000/'; 
Var static Url = site Url + 'static/'; 
var min width = 100; 
var min height = 100; 
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function bookmarklet (msg) { 
// Here goes our bookmarklet code 


}; 


// Check if jQuery is loaded 


if(typeof window.jQuery != 'undefined') { 
bookmarklet (); 

} else { 
// Check for conflicts 
Var conflict = typeof window.$ != 'undefined'7 


// Create the script and point to Google API 
Var script = document .createElement ('script"'); 
script.src = '//ajax.googleapis.com/ajax/libs/jquery/' + 
jquery version + '/jquery.min.js'; 
// Add the script to the "head' for processing 
document .head.appendChild (script); 
// Create a way to wait until script loading 
var attempts = 15; 
(function(){ 
// Check again if jQuery is undefined 
if (typeof window.jQuery == 'undefined') { 
if(--attempts > 0) { 
// Calls himself in a few milliseconds 
window.setTimeout (arguments.callee, 250) 
} else { 
// Too much attempts to load, send error 
alert ('An error ocurred while loading jQuery') 
外 
ESe 
bookmarklet () 
} 
0 


上 述 代 码 表示 为 jQuery 加 载 器 脚本 。 如 果 jQuery 已 经 加 载 至 当前 站 点 中 ， 该 脚本 负 
责 对 其 加 以 使 用 ， 如 果 jQuery 尚未 被 载 入 ， 该 脚本 将 从 Google 的 内 容 发 布 网 络 加 载 
jQuery， 进 而 设置 主流 的 JavaScript 框架 。 当 jQuery 加 载 完毕 后 ， 将 执行 bookmarkletO 
函数 ， 其 中 包含 了 我 们 需要 的 书签 工具 代码 。 除 此 之 外 ， 还 需 在 文件 开始 处 设置 某 些 变 
量 ， 如 下 所 示 。 

口 jquery_version: 表示 所 加 载 的 jQuery 版 本 。 
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口 site ur 和 static_ url: 表示 站 点 的 基 URL， 以 及 基本 静态 文件 的 URL。 

口 min_width 和 min height: 书签 工具 尝试 在 站 点 上 获取 图 像 的 最 小 宽度 和 高 度 (以 
像素 计算 ) 。 

下 面 实现 bookmarklet() 函 数 ， 其 定义 如 下 所 示 : 


function bookmarklet (msg) { 
// load css 
Var css = jQuery ('<link>'); 
css.attr({ 
rel: 'stylesheet', 
type: 'text/css', 
href: static url + 'css/bookmarklet.css?r=' + 
Math.floor (Math.random()*99999999999999999999) 
ys 
jQuery ('head') .append(css); 


// load HTML 

box html = '<div id="bookmarklet"><a href="#" 
id="close">g&times;</a><hl>Select an image to bookmark:</hli><div 
class="images"></div></div>'; 

jQuery ('body') .append (box html); 


// close event 
jQuery ('#bookmarklet #close') .click (function(){ 
jQuery ('#bookmarklet') .remove(); 
DD); 
] 7 
上 述 代码 的 工作 方式 如 下 所 示 : 

(1) 使 用 随机 数 作为 参数 加 载 bookmarklet.css 样式 表 ， 防 止 浏 览 器 返回 一 个 缓存 
区 件 s 

(2) 向 当前 站 点 的 <body> 文 档 元 素 中 添加 自 定义 HTML。 这 包括 一 个 <div> 元 素 ， 
它 将 包含 在 当前 网 站 上 获取 的 图 像 。 

(3) 当 用 户 单 击 HTML 块 的 关闭 链接 时 , 我 们 添加 了 一 个 事件 ， 用 以 移 除 源 自 当前 
文档 的 HTML .这 里 还 使 用 了 #bookmarklet #close 选择 器 获取 包含 ID 名 为 close 的 HIML 
元 素 ， 其 中 包含 了 ID 名 为 bookmarklet 的 父 元 素 。jQuery 选择 器 支持 获取 HTML 元 素 ， 
并 可 返回 即 定 CSS 选择 器 获取 的 全 部 元 素 。 读 者 可 访问 https://api.jquery.com/category/ 
selectors/ 以 查看 jQuery 选择 器 列表 。 

在 加 载 了 CSS 样式 表 和 书签 工具 代码 后 ， 下 一 步 是 获取 站 点 上 的 图 像 。 对 此 ， 可 在 
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bookmarklet0 函 数 中 添加 下 列 JavaScript 代码 : 


// find images and display them 
jQuery.each (jQuery ('img[src$="jpg"]'), function(index, image) { 
if (jQuery (image) .width() >= min width && jQuery (image) .height () 
>= min height) 
、 image Url = jQuery (image) .attr('src'); 
jQuery('#bookmarklet .images') .append('<a href="#"><img src="'+ 
image url +'" /></a>'); 
} 
上 述 代码 使 用 了 img[src$- jpg ] 选 择 器 获取 所 有 的 <img> HTML 元 素 , 其 src 属性 以 
jpg 字符 串 结 束 。 这 意味 着 ， 我 们 将 搜索 显示 于 当前 站 点 上 的 全 部 JPEG 图 像 。 随 后 ， 通 
过 jQuery 的 each() 方 法 对 结果 进行 遍历 。 对 于 尺寸 大 于 min_ width 和 min_height 变量 指 
定 的 图 像 ， 将 其 添加 至 <div class="images"> HTML 容器 中 。 
用 户 应 能 够 在 任何 站 点 上 加 载 bookmarklet， 包 括 通 过 HTTPS 提供 服务 的 站 点 。SSL 
已 经 被 广泛 使 用 ， 现 在 大 多 数 网 站 都 可 通过 HTTPS 提供 内 容 。 出 于 安全 原因 ， 对 于 通过 
HTTPS 提供 服务 的 站 点 上 ， 浏 览 器 将 阻止 运行 基于 HTTP 的 书签 工具 。 
Django 开发 服务 器 仅 适 用 于 开发 过 程 ， 且 不 支持 HITPS。 当 测试 HITP 上 的 书签 了 
有 具 时 ， 我 们 将 采用 Ngrok。Ngrok 工具 将 创建 一 个 通道 ， 并 通过 HTTP 和 HTTPS 向 联 
网 公开 本 地 主机 。 
用 户 可 访问 https://ngrok.com/download 下 载 Ngrok， 并 通过 下 列 命令 在 Shell 中 运行 
Nerok: 
./ngrok http 8000 


通过 上 述 命令 ， 将 通知 Ngrok 在 8000 端口 上 针对 本 地 主机 创建 一 个 通道 ， 并 为 其 分 
配 一 个 可 供 互联 网 访问 的 主机 名 。 对 应 输出 结果 如 下 所 示 : 


Session Status online 

Version 和 2 

Region United States (us) 

Web Interface http://127.0.0.1:4040 

Forwarding http://3f6ad53c.ngrok.io -> localhost:8000 

Forwarding https://3f6ad53c.ngrok.io -> localhost:8000 
Connnections ct opn Tt ES p50 p90 


0 0 0.00 0.00 0.00 0.00 
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Ngrok 告诉 我 们 , 站 点 使 用 Django 的 开发 服务 器 在 本 地 主机 8000 端口 上 运行 ， 分 别 
使 用 HTTP 和 HTTPS 协议 通过 http://3f6ad53c.ngrok.io 和 https://3f6ad53c.ngrok.io URL 在 
互联 网 上 可 用 。 此 外 ,Ngrok 还 提供 了 一 个 URL 以 访问 Web 界面 并 显示 与 请 求 相关 的 信 
息 ， 此 类 请 求 在 本 地 主机 4040 端口 上 发 送 至 服务 器 。 
编辑 项 目的 settings.py 文件 ， 并 将 Ngrok 提供 的 主机 添加 至 ALLOWED_HOSTS 设 
置 中 ， 如 下 所 示 : 
ALLOWED HOSTS = [ 
'mysite.com', 
"localhost', 


SE Oy 
'3f6ad53c .ngrok.io' 


] 


这 将 通过 新 的 主机 名 服务 于 当前 应 用 程序 。 随 后 ， 在 浏览 器 中 打开 https://3f6ad53c. 
ngrok.io/account/login/， 并 利用 Ngrok 提供 的 主机 蔡 换 现 有 的 主机 ， 即 可 访问 登录 站 点 。 
编辑 bookmarklet launcherjs 模板 ， 并 利用 Ngrok 提供 的 HITPS URL 替换 http:/127.0.0.1: 
8000/URL， 如 下 所 示 : 
(function(){ 
if (window.myBookmarklet !== undefined){ 
myBookmarklet (); 
} 
else { 
document .body.appendchild (document .createElement ('script')) .src='https:// 
3f6ad53c.ngrok .io/static/js/bookmarklet .js?r="'+Math.floor (Math.random()* 
99999999999999999999}3> 
} 
A 


编辑 js/bookmarklet.js 静态 文件 并 查看 下 列 代码 行 : 

var site url = "http://127.0.0.1:8000/"; 

利用 下 列 代码 行进 行 蔡 换 ， 并 包含 Ngrok 提供 的 HTTPS URL: 

site url = 'https://3f6ad53c.ngrok.io/'; 

浏览 器 中 打开 https://3f6ad53c.ngrok.io/account/， 利 用 Ngrok 提供 的 主机 蔡 换 现 有 的 
主机 。 用 户 登录 后 将 BOOKMARK IT 按钮 拖 忠 至 浏览 器 的 书签 工具 栏 中 ， 如 图 5.6 所 示 。 


浏览 器 中 打开 某 个 站 点 并 单 击 书签 工具 ， 随 后 将 显示 一 个 框 体 ， 其 中 显示 了 尺寸 大 
于 100x100 像素 的 所 有 JPEG 图 像 ， 如 图 5.7 所 示 。 


页 攻 
尖 H 
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& 3f6ad53c.ngrok io/account/ 


Bookmarks 


Dashboard 
‘Welcome to your dashboard. You have bookmarked 0 images. 


Drag the following buton to your bookmarks toolbar to bookmark images from otner webstes = 37770 


You can also edit your profile or change your password. 


Select an image to bookmark: 
amazon 
ee 


1-16 0f 11,256 


ic unlimited 


cos& Vinyt 


Introducing Amazon Music Unlimited. Listen to any song, anywhere. 


Showing most relevant results. See all results for 


International Shipping mw 
Ship to Spaln 


Amazon Prime 


Eligible for Free Shipping 


图 5.7 


HTML 容器 包含 了 可 执行 书签 操作 的 全 部 图 像 ， 用 户 可 单 击 对 应 的 图 像 并 将 其 设置 
为 书签 。 编 辑 js/bookmarkletjs 静态 文件 ， 并 在 bookmarklet0 函 数 中 添加 下 列 代码 : 


// when an image is selected open URL with it 

jQuery ('#bookmarklet .images a').click(function(e){ 
selected image = jQuery (this) .children('img') .attr('src'); 
// hide bookmarklet 
jQuery ('#bookmarklet') .hide(); 
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// open new window to submit the image 
window.open(site url +'images/create/?url=" 


]) 


量 


- + + 


encodeURIComponent (selected image) 
'&gtitle=" 

encodeURIComponent (jQuery ('title') .text ()), 
blank'); 


上 述 代码 的 工作 方式 解释 如 下 
(1) 将 click0 事 件 绑 定 至 图 像 的 链接 元 素 上 。 


(2) 当 用 户 单 击 某 


的 URL。 


(3) 我 们 隐藏 了 书签 工具 。 针 对 站 点 上 新 图 像 的 书签 i 
-个 新 的 浏览 器 窗口 ， 并 作为 GET 参数 传递 
在 浏览 器 中 打开 新 的 URL， 再 次 单 击 书 


幅 图 像 时 ， 可 设置 新 变量 selected_image， 其 中 包含 了 所 选 图 像 


没 置 ， 利 用 对 应 的 URL 打开 
的 <title> 元 素 以 及 所 选 图 像 的 URL。 
具 以 显示 图 像 选取 框 。 如 果 单 击 了 某 幅 


图 像 ， 用 户 将 被 重 定向 至 图 像 生成 页 面 ， 并 作为 GET 参数 传递 站 点 的 标题 和 所 选 图 像 的 


URL， 如 图 5.8 所 示 。 


Bookmark an image 


至 此 ， 我 们 的 第 一 


Title: 


Django Reinhardt 


Description: 


图 5.8 
个 JavaScript 书签 工具 制作 完毕 ， 并 全 部 整合 至 Django 项 目 中 。 
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5.3 创建 图 像 的 细节 视图 


本 节 将 创建 一 个 简单 的 细节 视图 ， 并 显示 一 幅 存 储 于 站 点 中 的 图 像 。 对 此 ， 打 
images 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.shortcuts import get object or 404 
from .models import Image 


def image detail (request, id, slug): 
image = get object or 404(Image, id=id, slug=slug) 
return render (request， 
'images/image/detail.html', 
{'section': 'images', 
"image': image}) 
上 述 代码 展示 了 一 个 简单 的 视图 并 可 显示 一 幅 图 像 。 编 辑 iamges 应 用 程序 的 urls.py 
文件 ， 并 添加 下 列 URL 路 径 : 
path('dqetail/<int:id>/<slug:slug>/ 
Views.image detail, name='detail'), 
编辑 images 应 用 程序 的 models.py 文件 ， 并 向 Image 模型 中 添加 get_absolute_url() 
方法 ， 如 下 所 示 : 


from django.urls import reverse 


class Image (models .Model): 
a 
def get absolute url (self): 
return reverse('images:detail', args=[self.id, self.slug]) 
记 住 ， 为 对 象 提供 规范 URL 的 常见 模式 是 在 模型 中 定义 get_absolute_url0 方 法 。 
最 后 ， 在 iamges 应 用 程序 的 /images/image/ 目 标 目录 中 创建 一 个 模板 ， 将 其 命名 为 
detailhtml 并 添加 下 列 代码 : 


{gs extends "base-htmln $%} 


{$$ block title %}{{ image.title }}{% endblock %} 


{$$ block content %} 
<hl>{{ image.title }}</hl> 
<img src="{{ image.image.url }}" class="image-detail"> 
{s with total likes=image.users like.count $%} 
<div class="image-info"> 
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<div> 
<span class="count"> 
{{ total likes }} like{{ total likes|lpluralize }} 
</span> 
</div> 
{{ image.description|linebreaks }} 
</div> 
<div class="image-likes"> 
{% for user in image.users like.all $%} 
<div> 
<img src="{{ user.profile.photo.url }}"> 
<p>{{ user.first name }}</p> 
</div> 
{%S empty %} 
Nobody likes this image yet. 
{s endfor $} 
</div> 
{S$ endwith %} 
{%S endblock %} 


上 述 代码 显示 了 当前 模板 以 及 书签 图 像 的 细节 内 容 。 这 里 可 使 用 {% with %} 标 签 存 
储 QuerySet 的 结果 ， 并 在 total_likes 变量 中 计算 该 图 像 的 受 欢迎 程度 。 据 此 ， 可 避免 重 
复 计算 同一 QuerySet。 另 外 ， 此 处 还 包含 了 图 像 的 描述 内 容 ， 同 时 还 将 遍历 
image.users_like.all 以 显示 喜欢 该 图 像 的 所 有 用 户 。 


@ 注意 , 
使 用 {% with %} 模 板 标签 对 于 防止 多 次 计算 QuerySets 是 否 有 用 


接 下 来 ， 将 使 用 书签 工具 对 一 幅 新 图 像 执行 书签 设置 操作 。 在 用 户 发 布 了 图 像 后 ， 
将 被 重 定向 至 图 像 的 细节 页 面 ， 该 页 面 中 包含 了 一 条 成 功 消 息 ， 如 图 5.9 所 示 。 


Django Reinhardt 


The Essential Diango Reinhardt 


Nobody likes this image yet 
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5.4 利用 sorl-thumbnail 生成 图 像 缩 略图 


前 述 内 容 讨论 了 在 细节 页 面 上 显示 原始 图 像 ， 但 对 于 不 同 的 图 像 ， 其 尺寸 可 能 变化 
较 大 。 另 外 ， 某 些 图 像 的 原始 文件 可 能 较 大 ， 其 加 载 过 程 也 较为 耗 时 。 针 对 于 此 ， 以 统 
一 方式 显示 优化 图 像 的 最 佳 方式 是 生成 缩 略 图 ,下面 将 采用 名 为 sorl-thumbnail 的 Django 
应 用 程序 执行 这 一 任务 。 

打开 终端 并 利用 下 列 命令 安装 sorl-thumbnail: 


pip install sorl-thumbnail==12.4.1 


编辑 bookmarks 项 目的 settingspy 文件 ， 向 INSTALLED APPS 设置 中 添加 sorLthumbnail， 
如 下 所 示 : 
INSTALLED APPS = [ 
: 
'sorl .thumbnail', 
] 


随后 ， 运 行 下 列 命令 将 应 用 程序 与 数据 库 同步 : 

python manage.py migrate 

对 应 输出 结果 如 下 所 示 : 

Applying thumbnail.0001 initial... OK 

sorl-thumbnail 提供 了 不 同 的 方式 可 定义 图 像 缩 略图 。 有 具体 来 说 ， 该 应 用 程序 提供 了 
{9% thumbnail 96} 模 板 标签 ， 并 可 在 模板 中 生成 缩 略 图 ， 如 果 希 望 在 模型 中 定义 缩 略 图 ， 
还 将 生成 一 个 自 定义 的 ImageField。 这里, 我们 将 采用 模板 标签 方案 。 对 此 , 编辑 images/ 
image/detail.html 模板 ， 并 查看 下 列 代码 行 : 

<img src="{{ image.image.url }}" class="image-detail"> 

利用 下 列 代码 对 其 进行 替换 : 

{$s load thumbnail %} 

{s thumbnail image.image "300" as im %} 

<a href="{{ image.image.url }}"> 
<img src="{{ im.url }}" class="image-detail"> 


</a> 
{$$ endthumbnail %} 
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此 处 定义 了 一 个 固定 宽度 为 300 像素 的 缩 略 图 。 当 用 户 首 次 加 载 该 页 面 时 ， 将 创建 


一 个 缩 略 图 页 面 ， 生 成 后 的 缩 略 图 将 在 后 续 请 求 中 加 以 使 用 。 利 用 python manage.py 
runserver 命令 启动 开发 服务 器 ， 访 问 现 有 图 像 的 图 像 详细 页 面 。 随 后 ， 缩 略图 将 在 站 点 


中 生 显示 。 


sorl-thumbnail 应 用 程序 提供 了 多 项 选择 以 定制 缩 略图 ， 包 括 剪裁 算法 以 及 不 同 的 应 


效果 。 如 果 在 缩 略 图 生成 过 程 中 遇 到 任何 问题 ， 可 向 settings.py 文件 中 添加 THUMBNAIL_ 
DEBUG = True， 进 而 获取 相关 的 调试 信息 。 关 于 sorl-thumbnail 应 用 程序 的 完整 文档 ， 读 
者 可 访问 https://sorl-thumbnail.readthedocs.io/ 以 了 解 更 多 内 容 。 


5.5 利用 jQuery 添加 AJAX 操作 


面向 应 用 程序 中 添加 AJAX 操作 。AJAX 是 异步 JavaScript 和 XML 的 简称 ， 并 涵 


盖 了 相关 技术 并 生成 异步 HTTP 请求。AJAX 可 通过 异步 方式 从 服务 器 发 送 和 检索 数据 ， 
上 且 无 须 重 载 整个 页 面 。 尽 管 名 称 中 涵盖 了 XML， 但 这 一 内 容 并 非 必需 。 我 们 也 可 通过 其 


他 格式 发 送 或 检索 数据 ， 


如 JSON、HTML 或 纯 文本 。 


` 面 将 向 图 像 详细 页 面 添加 一 个 链接 ， 用 户 可 单 击 该 链接 以 表示 对 图 像 的 喜爱 。 此 


处 将 利用 AJAX 执行 这 项 操作 ， 以 避免 重 载 整 个 页 面 。 首 先 ， 可 创建 一 个 用 户 视 图 ， 并 
以 此 显示 用 户 喜 欢 或 不 喜欢 相关 图 人像。 编辑 images 应 用 程序 的 views.py 文件 ， 并 向 其 中 


添加 下 列 代码 : 


from django.http 


import JsonResponse 


from django.views.decorators.http import require POST 


@login required 
@require POST 


def image like (request) : 
image id = request.POST.get ('id') 
action = request.POST.get ('action') 
if image id and action: 


try: 


image = Image.objects.get (id=image id) 
if action == "1ike': 


else 


image.users like.add (request.user) 


image.users like.remove (request.user) 


return JsonResponse({'status':"'ok'}) 
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except: 
pass 
return JsonResponse({'status':"'ko'}) 


这 里 针对 视图 使 用 了 两 个 装饰 器 。 其 中 ，login_required 装饰 器 可 阻止 未 登录 用 户 访 
问 该 视图 。 如 果 HTTP 请 求 未 经 过 POST 实现 ，require POST 装饰 器 将 返回 一 个 
HttpResponseNotAllowed 对 象 〈 如 状态 码 405) 。 除 此 之 外 ，Django 还 提供 了 一 个 
require_GET 装饰 器 〈 仅 支持 GET 请 求 ) ， 以 及 一 个 require_http_ methods 装饰 器 ， 并 可 
作为 参数 向 其 传递 一 个 所 支持 的 方法 列表 。 

当前 视图 使 用 了 以 下 两 个 GET 参数 。 

口 image id: 表示 图 像 对 象 的 IDP， 用 户 在 该 对 象 上 执行 相关 操作 。 

口 action: 用 户 所 需 执行 的 操作 ， 假 设 定义 为 一 个 包含 like 或 unlike 值 的 字符 串 。 

对 于 Image 模型 的 users_like 多 对 多 字段 ， 我 们 使 用 了 Django 提供 的 管理 器 ， 并 通 
过 add0) 或 remove0 添 加 或 移 除 关系 对 象 。 当 调用 add0 方 法 时 ， 也 就 是 说 ,传递 一 个 已 存 
在 于 关系 对 象 集中 的 对 象 并 不 会 对 其 执行 复制 操作 ， 当 调用 remove0 方 法 时 ， 传 递 一 个 
未 处 于 关系 对 象 集中 的 对 象 将 不 会 执行 任何 操作 。 另 一 个 较为 有 用 的 多 对 多 方法 则 是 
clear()， 该 方法 将 从 关系 对 象 集中 移 除 全 部 对 象 。 

最 后 ， 我 们 还 使 用 了 Django 提供 的 JsonResponse 类 ， 该 类 返回 包含 application/json 
内 容 类 型 的 HTTP 响应 ， 并 将 给 定 对 象 转换 为 JSON 输出 。 

编辑 images 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 


path('like/', views.image like, name='like'), 


5.5.1 加 载 jQuery 


我 们 需要 向 图 像 细 节 模 板 中 添加 AJAX 功能 ， 为 了 在 模板 中 使 用 jQuery， 首 先 可 将 
其 置 于 项 目的 base.html 模板 中 。 对 此 ， 编 辑 account 应 用 程序 的 base.html 模板 ， 并 在 
</body> HTML 闭合 标签 之 前 添加 下 列 代码 ; 

<script 


src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/ 
jquery.min.js"></script> 


<script> 
$ (document) .ready (function(){ 
{S$ block domready %$} 
{$$ endblock $} 
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所 党 

</script> 

此 处 从 Google 的 CDN 加 载 了 jQuery 框架 ， 此外， 还 可 访问 https://jquery. com/ 下 载 
jQuery， 并 将 其 添加 至 应 用 程序 的 static 目录 中 。 

另外 ， 我 们 加 入 了 <scrip 亿 标签 以 包含 JavaScript 代码 。ready0 定 义 为 一 个 jQuery 函 
数 ， 该 函数 接收 一 个 句柄 ， 并 在 DOM 结构 构件 完备 后 被 执行 。DOM 是 文档 对 象 模型 的 
简称 ， 当 Web 页 面 被 载 入 时 由 浏览 器 创建 ， 同 时 构建 为 对 象 的 树 形 结构 。 据 此 ， 可 确保 
所 交互 的 所 有 HTML 元 素 加 载 至 DOM 中 。 当 DOM 准备 就 绪 后 ， 代 码 仅 执行 一 次 。 

在 文档 处 理 函 数 内 部 ， 我 们 设置 了 名 为 domready 的 Django 模板 块 ， 其 中 ， 扩 展 了 
基 模 板 的 模板 可 包含 特定 的 JavaScript。 

这 里 ， 读 者 不 可 将 JavaScript 代码 和 Django 模板 标签 混为一谈 。Dijango 模板 语言 在 
服务 器 端 显 示 ， 并 输出 最 终 的 HTML 文档， 而 JavaScript 则 在 客户 端 一 侧 执行 。 某 些 时 
候 ， 可 利用 Django 以 动态 方式 生成 JavaScript 代码 。 

在 本 章 示例 代码 中 ， 在 Django 模板 中 包含 了 JavaScript 代码 。 对 此 ， 一 种 首选 方案 
是 通过 加 载 .js 文件 包含 JavaScript 代码 ， 并 用 作 静 态 文 件 ， 尤 其 是 此 类 文件 较 大 时 。 


5.5.2 ”AJAX 请 求 中 的 跨 站 点 请 求 伪造 


第 2 章 曾 讨 论 了 跨 站 点 请 求 伪 造 。 利 用 CSRF 保护 ，Django 在 所 有 的 POST 请 求 中 
检测 CSRF 令 牌 。 当 提交 表单 时 ， 可 使 用 {% csrf token %} 模 板 标签 连同 当前 表单 发 送 令 
牌 。 对 于 AJAX 请 求 来 说 ， 将 CSRF 令 牌 作为 POST 数据 传递 到 每 个 POST 请 求 中 稍 显 
不 便 。 因 此 ，Django 允许 利用 CSRF 令 牌 值 在 AJAX 请 求 中 设置 自 定义 X-CSRFToken 
头 。 这 可 设置 jQuery 或 其 他 JavaScript 库 ， 并 自动 在 每 个 请 求 中 设 定 X-CSRFToken 头 。 

为 了 在 所 有 请 求 中 包含 令 牌 ， 需 要 执行 下 列 各 项 步骤 : 

(1) 从 csrftoken Cookie 中 检索 CSRF 令 牌 ， 该 令 牌 在 CSRF 处 于 活动 状态 时 被 设置 。 
(2) 利用 X-CSRFToken 头 在 AJAX 请 求 中 发 送 该 令 牌 。 

关于 CSRF 和 AJAX 的 更 多 信息 ,读者 可 访问 https://docs.djangoproject.com/en/2.0/ref/ 
Csrf/#ajax。 

编辑 base.html 模板 中 最 新 添加 的 代码 ， 如 下 所 示 : 

<script 

src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js" 


></sc 
ript> 
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<script 
src="https://cdn.jsdelivr.net/npm/js-cookie@2/src/js.cookie.min.js"> 
</script> 
<script> 
Var csrftoken = Cookies.get('csrftoken'); 
function csrfSafeMethod(method) { 
// these HTTP methods do not require CSRF protection 
return (/^ (GET|HEAD|OPTIONS|TRACE)$/.test (method)); 
} 
$.ajaxSetup ({ 
beforeSend: function(xhr, settings) { 
if (!csrfSafeMethod(settings.type) && !this.crossDomain) { 
xhr.setRequestHeader ("X-CSRFToken", csrftoken); 
} 
} 
天 去 
$ (document) .ready (function (){ 
{$$ block domready %} 
{%$ endblock %$} 
]) 
</script> 


上 述 代 码 解 释 如 下 : 

(1) 此 处 从 公共 CDN 中 加 载 了 JS Cookie， 进 而 可 方便 地 与 Cookie 交互 。JS Cokie 
一 类 处 理 Cookie 的 轻 量 级 JavaScript。 读 者 可 访问 https://github.com/js-cookie/js-cookie 
以 了 解 更 多 内 容 。 

(2) 利用 Cookies.get0 读 取 csrftoken Cookie 值 。 

(3) 定义 csrfSafeMethod0) 函 数 以 检测 HTTP 方法 是 否 安全 。 相 应 地 ， 安 全 的 方法 并 
不 需要 使 用 CSRF 保护 一 一 它们 是 GRT、HEAD、OPTIONS 和 TRACE。 

(4) 利用 $.ajaxSetup0) 设 置 jQuery AJAX 请 求 。 在 每 个 AJAX 请 求 被 执行 之 前 ， 将 
检测 请 求 方法 是 否 安全 , 且 当 前 请 求 不 可 跨 域 。 若 请 求 处 于 不 安全 状态 , 则 利用 从 Cookie 
中 获取 的 值 设置 XCSRFToken 头 。 这 一 设置 将 应 用 于 通过 jQuery 执行 的 全 部 AJAX 请 求 。 

CSRF 令 牌 将 包含 在 所 有 使 用 不 安全 HITP 方法 (如 POST 或 PUT) 的 AJAX 请 求 中 。 


5.5.3 利用 jQuery 执行 AJAX 请 求 


编辑 images 应 用 程序 的 images/image/detail.html 模板 ， 并 查看 下 列 代码 : 


{s with total likes=image.users like.count %} 
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利用 下 列 代码 蔡 换 上 述 内 容 : 


{s with total likes=image.users like.count users like=image.users like.al1g} 
随后 ， 利 用 image-info 类 修改 <div> 元 素 ， 如 下 所 示 : 


<div class="image-info"> 
<div> 
<span class="count"> 
<span class="total">{{ total likes }}</span> 
like{{ total likes|lpluralize }} 
</span> 
<a href="#" data-id="{{ image.id }}" data-action="{% if 
request.user in users like %}un{% endif %}like" 
class="like button"> 
{% if request.user not in users like %} 
Like 
{% else %} 
Unlike 
{% endif %} 
</a> 
</div> 
{{ image.description11inebreaks }} 
</div> 


首先 ， 疝 {% with %} 模 板 标 签 中 添加 男 一 个 变量 ， 以 存储 image.users_like.all 的 查询 
结果 ， 同 时 避免 对 其 执行 两 次 。 此 处 显示 了 喜欢 该 图 像 的 全 部 用 户 数量 ， 并 包含 了 一 个 
喜欢 /不 喜欢 该 图 像 的 链接 : 这 里 将 检测 用 户 是 否 位 于 users_like 关系 对 象 集中 , 并 根据 用 
户 和 图 像 间 的 当前 关系 显示 like 或 unlike。 相应 地 , 可 向 <a> HTML 元 素 中 添加 下 列 属性 。 
口 data-id: 所 显示 的 图 像 人 D。 
口 ”data-action: 用 户 单 击 链接 时 所 执行 的 动作 ， 可 以 是 like 或 unlike。 
AJAX 请 求 中 的 两 个 属性 值 将 发 送 至 image_like 视图 中 。 当 用 户 单 击 like/unlike 链接 
时 ， 需 要 在 客户 端 执行 下 列 操作 : 
(1) 调用 AJAX 视图 ， 并 向 其 传递 图 像 ID 以 及 操作 参数 。 
(2) 如 果 AJAX 请 求 有 效 ， 则 利用 相反 操作 〈like/unlike) 更 新 <a> HTML 元 素 的 
data-action 属性 ， 并 修改 其 显示 文本 。 
(3) 更 新 所 显示 的 全 部 like 数量 。 
利用 下 列 代码 并 在 images/image/detail.html 模板 下 方 添加 domready 代码 块 : 


{$$ block domready %} 
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$('a.like') .click (function(e){ 
e.preventDefault (); 
$.post('{% url "images:like" %}', 
和 
id: $(this) .data('id'") ， 
action: $ (this) .data('action') 
}, 
function (data){ 
if (data['status'] == 'ok') 
{ 
var previous action = $('a.like') .data('action'); 


// toggle data-action 

$('a.like') .data('action', previous action == 'like' ? 
的 

// toggle link text 

$('a.like') .text (previous action == 'like' ? 'Unlike' 
Like'); 

// update total likes 

var previous likes = 

parseInt ($('span.count .total') .text()) 7 

$('span.count .total') .text (previous action == 'like' ? 
previous likes + 1 : previous likes - 1); 


} 
); 
站 
{$$ endblock $} 
上 述 代 码 解释 如 下 : 
(1) 使 用 了 S('a.like') jQuery 选择 器 获取 包含 like 类 的 、 所 有 HTML 文档 的 <a> 元 素 。 
(2) 针对 click 事件 定义 了 一 个 处 理 函数 ， 每 次 用 户 单 击 like/unlike 链接 时 将 执行 该 


(3) 在 处 理 函 数 内 部 ， 使 用 了 epreventDefault0 以 避免 默认 的 <a> 元 素 操 作 行为 。 这 


可 防止 链接 定向 至 任意 处 。 


(4) 使 用 $.postO 执 行 服务 器 的 异步 POST 请 求 。 另 外 ，jQuery 还 提供 了 一 个 $.get() 


方法 (执行 GET 请 求 ) 以 及 一 个 底层 的 $.ajax() 方 法 。 


(5) 采用 Django 的 {% url %} 模 板 标签 针对 AJAX 请 求 构建 URL。 
(6) 构建 POST 参数 字典 以 发 送 请 求 ， 通 常 为 Django 视图 所 期 望 的 ID 和 action 参 


数 。 对 此 ， 可 从 <a> 元 素 的 data-id 和 data-action 属性 中 检索 此 类 值 。 
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(7) 定义 了 一 个 回调 函数 并 在 接收 HTTP 时 被 执行 。 该 函数 接收 包含 了 响应 内 容 的 
data 属性 。 
(8) 访问 接收 数据 的 status 属性 ， 并 检测 是 否 等 于 ok。 如 果 返 回 数据 正确 无 误 ， 将 
切换 链接 的 data-action 属性 及 其 文本 ， 这 可 使 用 户 取消 所 执行 的 操作 。 
(9) 取决 于 具体 操作 ， 可 逐一 增加 或 递减 likes 的 数量 。 
针对 所 上 传 的 图 像 ， 在 浏览 器 中 打开 图 像 详 细 页 面 。 图 5.10 显示 了 最 初 的 likes 的 数 
量 以 及 LIKE 按钮。 


图 5.10 


单 击 LIKE 按钮 ， 将 会 看 到 likes 的 计数 值 将 会 减 1， 同 时 按钮 文本 将 变 为 UNLIKE， 
如 图 5.11 所 示 。 


图 5.11 


当 单 击 INLOKE 按钮 时 ， 相 关 操 作 将 被 执行 ， 按钮 的 文本 将 变 回 LIKE， 同 时 计数 值 
也 随 之 改变 。 


当 采 用 JavaScript 进行 程序 设计 时 ， 尤 其 是 执行 AJAX 请 求 时 ， 建 议 针对 JavaScript 
调试 和 HTTP 请 求 使 用 相关 工具 。 通 常情 况 下 ， 可 单 击 鼠标 右键 ， 并 在 弹出 的 快捷 菜单 
中 选择 Inspect element 命令 访问 Web 开发 工具 。 


5.6 ”针对 视图 创建 自 定义 装饰 器 


我 们 可 对 AJAX 视图 进行 适当 限制 ， 且 仅 支 持 由 AJAX 生成 的 请 求 。Django 请 求 对 
象 提供 了 一 个 is_ajax() 方 法 ， 用 以 检测 请 求 是 否 通过 XMLHttpRequest 生成 ， 也 就 是 说 ， 
该 请 求 是 一 个 AJAX 请 求 。 对 应 值 在 HITP_X_ REQUESTED_WITH HTTP 头 中 被 设置 ， 
大 多 数 JavaScript 库 都 将 其 包含 在 AJAX 请 求 中 。 
当 对 视图 中 的 头 进 行 检 测 时 , 将 对 此 创建 一 个 装饰 器 。 这 里 ,装饰 器 定义 为 一 个 函数 ， 
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接收 另 一 个 函数 并 扩展 其 行为 ， 且 无 须 显 式 地 对 其 进行 修改 。 读 者 可 访问 https://www. 
python.org/dev/peps/pep-0318/ 以 了 解 与 装饰 器 相关 的 更 多 内 容 。 

考虑 到 装饰 器 应 具备 通用 特征 且 适 用 于 任意 视图 , 我 们 将 在 项 目 中 创建 一 个 common 
Python 包 。 对 此 ， 在 bookmarks 项 目 目录 中 创建 下 列 目录 和 文件 : 


common/ 
nit py 
decorators.py 


编辑 decorators.py 文件 并 添加 下 列 代码 : 


from django .http import HttpResponseBadRequest 


def ajax_required(f) : 
def wrap(request, *args, **kwargs): 
if not request.is ajax() : 
return HttpResponseBadRequest () 
return f(request, *args, **kwargs 
wrap. doc =f. doc 
wrap. name =f. name _ 
return wrap 


上 述 代码 表示 为 自 定义 的 ajax_required 装饰 器 ， 其 中 定义 了 一 个 wrap 函数 。 若 请 求 
并 非 是 AJAX， 该 函数 将 返回 一 个 HttpResponseBadRequest 对 象 (HTTP 404 代码 ) ， 和 否 
则 返回 装饰 后 的 函数 。 

接 下 来 ， 编 辑 iamges 应 用 程序 中 的 views.py 文件 ， 并 将 该 装饰 器 添加 至 image_like 
AJAX 视图 中 ， 如 下 所 示 : 

from common.decorators import ajax required 

@ajax required 

@login required 

@require POST 

def image like (request): 

Ee 

如 果 直 接 在 浏览 器 中 访问 http://127.0.0.1:8000/images/like/， 将 得 到 HTTP 400 响应 

代码 。 


全 提示 : 


如 果 发 现在 多 个 视图 中 重复 相同 的 检测 工作 ， 则 可 针对 视图 构建 自 定义 装饰 器 。 
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5.7 向 列表 视图 中 添加 AJAX 分 页 机 制 


由 于 需要 列 出 站 点 上 的 全 部 书签 图 像 ， 因 而 可 使 用 AJAX 分 页 机 制 构建 翻 页 功能 。 
当 用 户 阅读 至 页 面 底部 时 ， 将 自动 加 载 后 续 内 容 。 
下 面 将 实现 一 个 图 像 列 表 视 图 ， 以 处 理 标 准 浏览 器 请 求 和 AJAX 请 求 ， 同 时 还 包含 
了 分 页 机 制 。 当 用 户 在 初始 时 加 载 图 像 列表 页 面 时 ， 将 显示 第 一 个 图 像 页 面 。 当 阅读 至 
页 面 的 底 端 时 ， 则 通过 AJAX 后 续 页 面 ， 同 时 将 其 附 于 主页 面 的 底 端 。 
这 里 ， 同 一 视图 将 处 理 标准 分 页 和 AJAX 分 页 。 对 此 ,编辑 images 应 用 程序 的 views.py 
文件 ， 并 向 其 中 添加 下 列 代码 : 

from django.http import HttpResponse 


from django.core.paginator import Paginator, EmptyPage, \ 
PageNotAnInteger 


@login required 
def image list (request): 
images = Image.objects.all() 
paginator = Paginator (images, 8) 
page = request .GET.get ('page') 
Ee 
images = paginator.page (page) 
except PageNotAnInteger: 
# If page is not an integer deliver the first page 
images = paginator.page (1) 
except EmptyPage: 
if request.is ajax(): 
# If the request is AJAX and the page is out of range 
# return an empty page 
return HttpResponse('') 
# If page is out of range deliver last page of results 
images = paginator.page (paginator.num pages) 
if request.is ajax(): 
return render (request, 
'images/image/list ajax.html', 
{'section': 'images', 'images': images}) 
return render(request, 
'images/image/list.html', 
{'section': 'images', 'images': images}) 


在 该 视图 中 ， 将 创建 一 个 QuerySet 以 返回 源 自 数据 库 的 全 部 图 像 。 随 后 ， 将 设置 一 
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个 Paginator 对 象 并 对 结果 进行 分 页 ， 并 在 每 个 页 面 中 显示 8 幅 图 像 。 如 果 所 请 求 的 页 面 
超出 了 范围 ， 将 会 抛 出 一 个 EmptyPage 异常 。 对 此 ， 若 请 求 通过 AJAX 完成 ， 将 返回 一 
个 空 HttpResponse， 并 帮助 我 们 在 客户 端 结束 AJAX 分 页 进程 ， 并 将 结果 显示 在 两 个 不 
同 的 模板 中 ， 如 下 所 示 : 
口 对 于 AJAX 请 求 ， 将 显示 list_ajax.html 模板 ， 该 模板 仅 包含 请 求 页 面 的 图 像 。 
口 ” 对 于 标准 请 求 ， 将 显示 listhtml 模板 ， 该 模板 扩展 了 base.html 模板 以 显示 整个 
页 面 ， 同 时 还 包含 了 涵盖 图 像 列 表 的 list_ajax.html 模板 。 
编辑 images 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL: 


path('', views.image list, name="'list'), 


最 后 ， 还 需要 创建 一 个 刚刚 提 到 的 模板 。 对 此 ， 在 images/image/ 模 板 目 录 中 创建 新 
模板 ， 将 其 命名 为 list_ajax.html 并 添加 下 列 代 码 : 


{$$ load thumbnail $%} 


{% for image in images %} 
<div class="image"> 
<a href="{{ image.get absolute url }}"> 
{% thumbnail image.image "300x300" crop="100%" as im %} 
<a href="{{ image.get absolute url }}"> 
<img src="{{ im.url }}"> 
</a> 
{$$ endthumbnail %} 
</a> 
<div class="info"> 
<a href="{{ image.get absolute url }}" class="title"> 
{{ image.title }} 
</a> 
</div> 
</div> 
{s endfor 当 } 


上 述 模板 显示 了 图 像 列 表 ， 我 们 将 以 此 返回 AJAX 请 求 结果 。 在 同一 目录 中 创建 另 
一 个 模板 ， 将 其 命名 为 listhtml 并 添加 下 列 代码 : 


{$$ extends "base.-htmln $} 


{% block title %}Images bookmarked{fs endblock %} 


{$$ block content $} 
<hl>Images bookmarked</h1> 
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<div id="image-list"> 


{S$ include "images/image/list ajax.html" %} 
</div> 


{$$ endblock %$} 


该 列表 模板 扩展 了 basehtml 模板 。 为 了 避免 代码 重复 ， 此 处 包含 了 list_ajax.html 


示 图 像 。 当 阅读 至 页 面 底部 时 ，listhtml 模板 将 加 载 JavaScript 代码 ， 以 加 载 额 外 的 页 
问 listhtml 模板 中 添加 下 列 代码 : 


多 block domready %} 
Var page = 1; 
Var empty page = false; 


Var block request = false; 


和 


$ (window) .scroll (function() { 


Var margin = $ (document) .height() - $ (window) .height() - 200; 


if ($ (window) .scrollTop() > margin && empty page == false && 
block request == false) { 

block request = true; 

page += 1; 


$.get('?page=' + page, function(data) { 
if(data == '') { 


empty page = true; 
了 
else { 


block request = false; 


$('#image-list') .append (data); 
} 


区 
} 
]) 7 
{$$ endblock %$} 


上 述 代码 提供 了 页 面 滚动 功能 ， 并 在 定义 于 base.html 模板 中 的 domready 代码 块 中 
加 入 了 JavaScript 代码 。 对 应 代码 如 下 所 示 。 


(1) 首先 定义 了 下 列 变量 : 


口 ”page 用 于 存储 当前 页 面 号 。 


口 通过 ar 可 知晓 用 户 是 否 处 于 最 后 一 个 页 面 中 ， 并 检索 空 页 面 。 一 旦 
得 到 了 一 个 空 页 面 , 将 终 oe 处 假设 没有 过 多 的 结果 )。 

口 block request 防止 在 AJAX 请 求 处 理 过 程 中 发 送 额外 请 求 。 

(2) 使 


$(window).scroll0 捕 捉 滚动 事件 ， 并 对 其 定义 处 理 函 数 。 
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(3) 通过 margin 变量 可 得 到 文档 整体 高 度 和 窗口 高 度 之 差 ， 这 表示 为 用 户 滚动 页 面 
时 剩余 内 容 的 高 度 。 我 们 将 从 该 结果 中 减 去 200, 进而 在 用 户 接近 页 面 底部 200 个 像素 时 
加 载 下 一 个 页 面 。 
(4) 如 果 未 出 现 其 他 AJAX 请 求 ， 我 们 仅 发 送 一 个 AJAX 请 求 (block_request 须 为 
False) ， 用 户 将 不 会 到 达 当 前 结果 的 最 后 一 个 页 面 (empty_page 也 为 False) 。 
(5) 将 block request 设置 为 True， 以 避免 滚 页 事件 触发 额外 的 AJAX 请 求 ， 同 时 将 
page 计数 器 加 1， 以 获取 下 一 个 页 面 。 
(6) 通过 $.get() 执 行 AJAX GET 请 求 ， 并 在 名 为 data 的 变量 中 得 到 HTML 响应 ， 
如 下 所 示 。 
口 ” 响 应 不 包含 任何 内 容 : 到 达 结 尾 且 没有 更 多 可 供 加 载 的 页 面 。 可 将 empty_page 
设置 为 True， 以 避免 额外 的 AJAX 请 求 。 
口 0 Ph 包含 了 相关 数据 : 我 们 使 用 image-list ID 将 数据 追加 到 HTML 元 素 
中 。 当 用 户 到 达 页 面 底 端 时 ， 页 面 内 容 会 在 垂直 方向 上 扩展 ， 并 追加 相关 结果 
内 容 。 
在 浏览 器 中 打开 http:/127.0.0.1:8000/images/， 图 5.12 显示 了 相应 的 书签 图 像 列表 。 


Images bookmarked 


Louls Armstrong Chick Corea Al Jarreau AlJarreau 


Ella Fitzgerald Glenn Miller Charlie Parker Nina Simone 


图 5.12 
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当 滚 动 至 页 面 下 方 时 ， 将 会 加 载 额外 的 页 面 。 这 里 ， 应 确保 通过 书签 工具 包含 了 8 
幅 图 像 ， 这 也 是 每 个 页 面 所 显示 的 图 像 数量 。 回 忆 一 下 ,我们 可 采用 Firebug 或 类 似 的 工 
具 跟 踪 AJAX 请 求 ， 并 对 JavaScript 代码 进行 调试 。 

最 后 , 编辑 account 应 用 程序 的 base html 模板 ,并 针对 主 菜单 的 图 像 条 目 添加 URL， 
如 下 所 示 : 


<li {% if section == "images" %}class="selected"{% endif %}> 
<a href="{% url "images:list" %}">Images</a> 
</1i> 


据 此 ， 可 从 主 菜 单 中 访问 图 像 列表 。 
5.8 本 章 小 结 


本 章 讨论 了 JavaScript 书签 工具 ， 并 将 其 他 站 点 的 图 像 分 享 至 当前 网 站 中 。 此 外 ， 本 
章 还 利用 jQuery 实现 了 AJAX 视图 ， 并 添加 了 AJAX 分 页 机 制 。 

第 6 章 将 介绍 关注 系统 和 活动 流 ， 同 时 还 将 与 通用 关系 、 信 号 以 及 去 规范 化 协同 工 
作 。 除 此 之 外 ， 第 6 章 还 将 学 习 如 何在 Django 的 基础 上 使 用 Redis。 


第 6 章 跟踪 用 户 活动 


第 5 章 通 过 jQuery 在 项 目 中 实现 了 AJAX 视图 ， 并 构建 了 JavaScript 书签 工具 在 当 
前 平台 上 共享 其 他 站 点 的 内 容 。 

本 章 将 学 习 如 何 打造 关注 系统 ， 同 时 创建 一 个 用 户 活动 流 。 读 者 将 会 看 到 Django 信 
号 的 工作 方式 ， 并 将 Redis 中 的 快速 IO 存储 整合 至 项 目 中 ， 进 而 存储 各 项 视图 。 

本 章 主 要 涉及 以 下 内 容 : 


ee 
二 | 
| 


针 刀 


瑟瑟 反 瑟 理 吕 是 


利用 
构建 关注 系统 。 

创建 活动 流 应 用 程序 。 
向 模型 添加 通用 关系 。 


中 间 模 型 创建 多 对 多 关系 。 


关系 对 象 优化 QuerySets。 


对 于 非 规范 化 计数 使 用 信号 。 
将 数据 项 视图 存储 于 Redis 中 。 


6.1 构建 关注 系统 


本 节 将 在 项 目 中 构建 关注 系统 ， 用 户 之 间 可 彼此 关注 ， 并 跟踪 其 他 用 户 在 平台 上 的 


共享 内 容 。 这 8 


户 ， 同时， 也 可 被 多 个 用 户 所 关注 。 
6.1.1 利用 中 间 模 型 创建 多 对 多 关系 


第 5 章 通过 向 某 一 关系 模型 中 添加 ManyToManyField 创建 了 多 对 多 关系 ， 同 时 令 


Django 针对 这 一 关系 生成 了 数据 库 表 。 该 方案 适 上 


已 ， 用 户 间 的 关系 表示 为 多 对 多 关系 。 也 就 是 说 ， 一 名 用 户 可 关注 多 个 用 


于 大 多 数 场 合 ， 但 有 些 时 候 可 能 需要 


针对 该 关系 构建 中 间 模 型 。 当 希望 存储 针对 该 关系 
模型 。 例 如 ， 关 系 创建 的 日 期 ， 或 者 描述 关系 本 质 


下 面 将 和 4 


E 成 一 个 中 间 模型 ， 进 而 构 对 


原因 : 


EE 用户 间 的 


的 附加 信息 时 ， 则 需要 构建 一 个 中 间 
的 某 个 字段 。 
关系 。 中 间 模 型 的 使 用 包含 以 下 两 个 


口 “ 我 们 希望 使 用 Django 提供 的 User 模型 ， 但 并 不 希望 对 其 加 以 修改 。 


。164 。 


Django 项 目 实例 精 解 〈 第 2 版 ? 


口 ”我 们 需要 存储 创建 对 其 关系 的 时 间 。 
编辑 account 的 models.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


class 


Contact (models .Model): 


user from = models.ForeignKey('auth.User', 


related name='rel from set', 
on _delete=models .CASCADE) 


user to = models.ForeignKey('auth.User', 


related name='rel to set', 
on delete=models .CASCADE) 


created = models.DateTimeField(auto now add=True, 


db index=True) 


class Meta: 


ordering = ('-created',) 


def _ str (self): 


return '{} follows {}'.format (self.user from, 
self.user to) 


上 述 代码 显示 了 针对 用 户 关系 的 Contact 模型 ， 并 包含 以 下 字段 。 

口 user from: 创建 对 应 关系 的 用 户 ForeignKey。 

口 user to: 被 关注 用 户 的 ForeignKey。 

口 created: 包含 auto_ now_add=True 的 DateTimeField 字段 ， 以 存储 创建 对 应 关系 

的 时 间 值 。 

数据 库 索 引 将 在 ForeignKey 字段 上 自动 被 创建 。 我 们 使 用 db_index=True 针对 已 生成 的 
字段 创建 数据 库 索引 。 当 通过 该 字段 对 QuerySets 进行 排序 时 ， 这 可 有 效 地 改善 查询 性 能 。 

当 采 用 ORM 时 ， 对 于 两 个 用 户 间 的 关注 问题 (如 userl 和 user2) ， 可 生成 一 个 关 
系 ， 如 下 所 示 : 


userl 
user2 


= User.objects.get (id=1) 
= User.objects.get (id=2) 


Contact .objects.create (user from=userl, user to=user2) 


对 于 Contact 模型 ， 关 系 管理 器 rel from set 和 rel to_set 将 返回 一 个 QuerySet。 为 


了 访问 源 


User 模型 的 关系 的 终端 ，User 应 包含 ManyToManyField， 如 下 所 示 : 


following = models.ManyToManyField('self', 


through=Contact, 
related name="'followers', 
symmetrical=False) 
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上 述 代码 通知 Django 针对 当前 关系 使 用 自 定义 中 间 模 型 ， 即 向 ManyToManyField 
添加 through=Contact， 这 可 是 为 User 模型 至 其 自身 的 多 对 多 关系 。 我 们 引用 了 
ManyToManyField 字段 中 的 self 针对 同一 模型 生成 了 一 个 关系 。 

Oi: 

当 需 要 在 多 对 多 关系 中 使 用 附加 字段 时 ， 可 针对 关系 各 端 利 用 ForeignKey 创建 一 个 
自 定义 模型 。 可 将 ManyToManyField 添加 至 某 一 关系 模型 中 并 通知 Django， 应 将 中 间 模 
型 置 入 through 参数 中 进而 对 其 加 以 使 用 。 


如 果 Use 模型 表示 为 当前 应 用 程序 中 的 部 分 内 容 ， 可 将 上 一 个 字段 添加 至 模型 中 。 
然而 , 我 们 无 法 直接 修改 User 类 , 其 原因 在 于 , 该 类 隶属 于 django.contrib.auth 应 用 程序 。 
这 里 将 采用 一 种 稍微 不 同 的 方案 , 即 向 User 模型 中 动态 地 添加 该 字段 。 对 此 , 编辑 account 
应 用 程序 的 models.py 文件 ， 并 添加 下 列 代码 行 : 


from django.contrib.auth.models import User 


# Add following field to User dynamically 
User.add to class('following', 
models.ManyToManyField('self', 
through=Contact, 
related name='followers', 
symmetrical=False)) 
上 述 代码 使 用 了 Django 模型 的 add to_class() 方 法 ， 以 对 User 模型 设置 猴子 补丁 
(monkey patch) 。 需 要 注意 的 是 ， 在 将 字段 添加 至 模型 中 时 ， 使 用 add_to_class() 方 法 并 
非 是 一 种 推荐 方案 。 然 而 ， 此 处 使 用 这 一 方案 的 原因 在 于 : 
口 ” 通 过 基于 user.followers.all0 和 userfollowing.all0 的 Django ORM,， 简 化 了 关系 对 
象 的 检索 方式 。 我 们 使 用 中 间 Contact 模型 ， 并 避免 了 涉及 额外 数据 库 连 接 的 复 
杂 查 询 一 一 如 果 在 自 定义 Profile 模型 中 定义 了 关系 ， 即 会 出 现 这 种 情况 。 
口 多 对 多 关系 表 可 通过 Contact 模型 予以 创建 。 因此 ,对 于 Django User 模型 来 说 ， 
动态 添加 的 ManyToManyField 并 不 意味 着 会 产生 数据 库 变化 。 
口 ”这 里 并 不 打算 使 用 自 定义 用 户 模型 ， 而 是 选择 Django 的 内 置 User 模型 。 
注意 ， 在 大 多 数 时 候 ， 建 议 向 之 前 创建 的 Profile 模型 中 添加 字段 ， 而 不 是 对 User 模 
型 设置 猴子 补丁 。Django 还 支持 自 定 义 的 用 户 模型 。 如 果 读 者 希望 使 用 自 定 义 用 户 模型 ， 
可 访问 ， 以 查看 https://docs.djangoproject.com/en/2.0/topics/auth/customizing/#specifying-a- 
custom-user-model 相关 文档 。 
读者 可 能 已 经 注意 到 ， 上 述 关 系 包含 了 symmetrical=False 。 当 对 模型 自身 定义 


“166* Django 项 目 实例 精 解 (第 2 版 


ManyToManyField 时 ，Django 强制 该 关系 呈 对 称 状态 。 对 此 ， 可 设置 symmetrical=False 
并 定义 一 种 非 对 称 关系 。 也 就 是 说 ， 如 果 我 关注 了 你 ， 并 不 意味 着 你 会 自动 关注 我 。 
© 注意 ， 

当 针 对 多 对 多 关系 使 用 中 间 模 型 时 ， 一 些 相 关 的 管理 器 方法 将 会 被 禁用 ， 如 add()、 
create() 或 remove()。 用 户 需 要 创建 或 删除 中 间 模 型 实例 。 

运行 下 列 命令 ， 并 针对 account 应 用 程序 生成 初始 迁移 : 

Python manage.py makemigrations account 

对 于 输出 结果 如 下 所 示 : 


Migrations for 'account': 
account/migrations/0002 contact.py 
- Create model Contact 


运行 下 列 密码 将 应 用 程序 与 数据 库 同 步 : 
Python manage.py migrate account 
对 应 输出 结果 如 下 所 示 : 

Applying account.0002 contact... OK 


当前 ，Contact 模型 与 数据 库 同步 ， 进 而 可 创建 用 户 间 的 关系 。 然 而 ， 当 前 网 站 尚 无 
法 浏览 用 户 ， 或 查看 特定 的 用 户 配置 内 容 。 下 面 针 对 User 模型 构建 列表 和 详细 视图 。 


6.1.2 ”针对 用 户 配置 创建 列表 和 详细 视图 


打开 account 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.shortcuts import get object or 404 
from django.contrib.auth.models import User 


@login required 
def user list(request): 
users = User.objects.filter(is active=True) 
return render (request, 
'account/user/list.html', 
{'section': 'people', 
'users': users}) 


@login required 
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def user detail (request, username): 
user = get object or 404 (User, 
username=username, 
is active=True) 
return render(request, 
'account/user/detail.html', 
{'section': "people'， 
'user': user}) 


上 述 代码 展示 了 针对 user 对 象 的 简单 列表 和 详细 视图 。 其 中 , user_list 视图 用 于 获取 
处 于 活动 状态 的 全 部 用 户 。Django User 模型 包含 了 is_active 标记 ， 并 以 此 表明 当前 用 户 
账户 是 否 处 于 活动 状态 。 通 过 is_active=True， 我 们 可 对 查询 进行 过 滤 ， 且 仅 返 回 处 于 活 
动 状 态 的 用 户 。 该 视图 将 返回 结果 ， 但 可 添加 相应 的 分 页 机 制 ( 参 见 之 前 的 image_ list 
视图 ) 以 对 其 进行 改进 。 

user_detail 0 了 get_object_or 404() 快 捷 方式 以 及 给 定 的 用 户 名 检索 活动 用 户 。 
如 果 不 存在 该 账号 下 的 活动 用 户 ， 该 视图 将 返回 HTTP 404 响应 结果 。 

编辑 account fe 时 序 的 urls.py 文件 ， 并 针对 每 个 视图 添加 URL 路 径 ， 如 下 所 示 ; 


urlpatterns = [ 


ss 
path('users/', Views.user list, name='user list'), 
Path ('users/<username>/'， Views.user detail, name='user detail'), 


] 


此 处 使 用 了 user_detail URL 路 径 针 对 用 户 生 成 规范 URL。 之 前 已 经 在 模型 中 定义 了 
get_absolute url(0) 方 法 ， 并 针对 每 个 对 象 返回 规范 URL。 另 一 种 指定 模型 URL 的 方式 是 ， 
向 当前 项 目 中 添加 ABSOLUTE_URL OVERRIDES 设置 ， 如 下 所 示 : 

编辑 项 目的 settings.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.urls import reverse lazy 


ABSOLUTE URL OVERRIDES = { 
"auth.user': lambda u: reverse lazy('user detail', 
args=[u.username]) 
} 


Django 将 向 ABSOLUTE_URL _OVERRIDES 设置 中 出 现 的 任意 模型 动态 地 添加 get_ 
absolute_url0 方 法 ， 该 方法 针对 设置 中 的 既定 模型 返回 对 应 的 URL。 对 于 当前 用 户 ， 此 处 返 
可 了 user_detail URL， 进 而 可 在 User 实例 上 使 用 get_absolute_ url0， 并 检索 其 对 应 的 URL。 

利用 python manage.py shell 命令 打开 Python Sehll， 运 行 下 列 代码 进行 测试 : 
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>>> from django .contrib.auth.models import User 
>>> user = User.objects.latest('id') 

>>> str(user.get absolute url()) 
'/account/users/ellington/' 


此 处 所 返回 的 URL 正 是 期 望 中 的 结果 。 此 外 ， 我们 需要 针对 刚刚 生成 的 视图 创建 模 
板 。 对 此 ， 可 向 account 应 用 程序 的 templates/account/ 目 录 中 添加 下 列 目 录 和 文件 : 


/user/ 
detail.html 
list.html 


编辑 account/user/list.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{g extends "base.html™" %} 
{$$ load thumbnail 要 } 


五 


{% block title %}People{% endblock %} 


{% block content $%} 
<hl>People</h1l> 
<div id="people-list"> 
{$$ for user in users %} 
<div class="user"> 
<a href="{{ user.get absolute Url }}"> 
{$$ thumbnail user.profile.photo "180x180" crop="100%" 
as im %} 
<img src="{{ im.url }}"> 
{S$ endthumbnail %} 
</a> 
<div class="info"> 
<a href="{{ user.get absolute url }}" class="title"> 
{{ user.get full name }} 
</a> 
</div> 
</div> 
{S$ endfor 委 } 
</div> 
{$$ endblock $} 


上 述 模 板 可 列 出 站 点 中 的 全 部 活动 用 户 。 随后, 可 遍历 既定 用 户 , 使 用 sorl-thumbnail 
的 {% thumbnail %} 模 板 标签 ， 并 生成 配置 图 像 缩 略图 。 
打开 当前 项 目的 base.html 模板 ， 在 下 列 菜单 项 的 href 属性 中 包含 user_list URL: 
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<1li {% if section == "people" %}class="selected"{% endif %}> 
<a href="{(% orl Muser Tist” %}">People</a> 
</1i> 


利用 python managepy runserver 命令 启动 开发 服务 器 ， 并 在 浏览 器 中 打开 http://127.0.0.1: 
8000/account/users/， 对 应 的 用 户 列 未 图 6.1 所 示 。 


图 6.1 
注意 ， 如 果 在 生成 缩 略 图 时 遇 到 任何 困难 ， 可 向 settings.py 文件 中 添加 THUMBNAIL _ 
DEBUG = True， 以 便 在 Shell 中 查看 调试 信息 。 
编辑 account 应 用 程序 的 account/user/detail.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{s% extends "base.htm]l™" %} 
{s load thumbnail $} 


{% block title %}{{ user.get full name }}{% endblock %} 
{% block content %} 
<hl>{{ user.get full name }}</h1l> 
<div class="profile-info"> 
{$ thumbnail user.profile.photo "180x180" crop="100%" as im %} 
<img src="{{ im.url }}" class="user-detail"> 
{$$ endthumbnail %} 
</div> 
{ 要 with total followers=user.followers.count %} 
<span class="count"> 
<span class="total">{{ total followers }}1</span> 
follower{{ total followers|pluralize }} 
</span> 
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<a href="#" data-id="{{ user.id }}" data-action="{% if request.user in 
user.followers.all gs}un{s endif %}follow" class="follow button"> 


{% if request.user not in user.followers.all %$} 
Follow 


{SS else $} 
Unfollow 
{S$ endif %} 
</a> 
<div id="image-list" class="image-container"> 
{% include "images/image/list ajax.html" with 
images=user.images created.all $%} 
</div> 
{g endwith %} 
{$$ endblock $} 


在 详细 模板 中 ， 将 显示 用 户 配 置 内 容 ， 并 采用 {% thumbnail %} 模 板 标 签 显示 配置 图 
像 。 这 里 显示 了 全 部 关注 者 的 数量 ， 以 及 一 个 链接 以 关注 /取消 关注 当前 用 户 。 另 外， 还 
将 执行 一 个 AJAX 请 求 以 关注 /取消 关注 某 个 特定 用 户 。 此 处 向 <a>HTML 元 素 添加 了 
data-id 和 data-action 属性 ， 其 中 包含 了 用 户 ID 和 单 击 时 所 执行 的 初始 活动 ， . follow 或 
unfollow， 这 取决 于 请 求 当前 页 面 的 用 户 是 否 为 关注 者 。 最后， 我 们 还 显示 了 用 户 所 收藏 
的 图 像 ， 同 时 包含 了 images/image/list_ajax.html 模板 。 

再 次 打开 浏览 器 单 击 某 个 用 户 《 该 用 户 收藏 某 些 图 像 ) ， 图 6.2 显示 了 某 些 配置 细节 
内 容 。 


Diango and Duke Louis Armstrong Chick Corea 


图 6.2 


6.1. 
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3 构建 AJAX 视图 以 关注 用 户 


本 节 将 使 用 AJAX 创建 一 个 简单 的 视图 ， 以 关注 /取消 关注 某 个 用 户 。 对 此 ， 编 辑 


account 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.http import JsonResponse 

from django.views.decorators.http import require POST 
from common.decorators import ajax required 

from .models import Contact 


@ajax required 
@require POST 
@login required 
def user follow(request): 
user id = request.POST.get ('id') 
action = request.POST.get ('action') 
if user id and action: 
PY 
user = User.objects.get (id=user id) 
if action == "follow': 
Contact .objects.get or create( 
user from=request.user, 
user to=user) 
elses 
Contact .objects.filter(user from=request.user, 
user to=user) .delete() 
return JsonResponse({'status':"'ok'}) 
except User.DoesNotExist: 
return JsonResponse({'status':"'ko'}) 
return JsonResponse({'status':'ko'}) 


user_follow 视图 类 似 于 之 前 创建 的 image_like 视图 。 由 于 针对 用 户 的 多 对 多 关系 使 


Ee 


J 


自 定 义 中 间 模 型 , 因而 无 法 提供 ManyToManyField 中 自动 管理 器 的 add0 和 remove(O) 


默认 方法 。 这 里 使 用 了 中 间 模 型 Contact 生成 或 删除 用 户 关系 。 


编辑 account 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 


path('users/follow/', views.user follow, name='user follow")， 


此 处 须 确保 将 上 述 路 径 置 于 user_detail URL 路 径 之 前 。 和 否则 ， 针 对 /users/follow/ 的 请 


求 将 与 user_detail 的 正则 表达 式 相 匹配 ， 进 而 执行 该 视图 。 回 忆 一 下 ， 在 每 个 HITP 请 
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求 中 ，Django 将 针对 每 个 路 径 〈 以 出 现 顺 序 为 准 ) 检测 所 请 求 的 URL， 并 在 首次 匹配 处 


停止 


编辑 account 应 用 程序 的 user/detail.html 文件 ， 并 添加 下 列 代码 : 


{$$ block domready $} 
$('a.follow') .click (function(e){ 
e.preventDefault (); 
$.post('{% url "user follow" %}', 
全 
id: $(this) .data('id')， 
action: $(this) .data('action') 
]} ， 
function (data) { 
if (data['status'] == 'ok') { 
var previous action = $('a.follow') .data('action'); 


// toggle data-action 
$('a.follow') .data('action', 
previous action == 'follow' ? "unfollow' : 'follow'); 


// toggle link text 
$('a.follow') .text ( 
previous action == 'follow' ? 'Unfollow' : 'Follow'); 


// update total followers 
var previous followers = parseInt( 
$('span.count .total') .text()); 
$('span.count .total') .text (previous action == 'follow' ? 
previous followers + 1 : previous followers - 1); 
} 
} 
); 
烛 汉 
{$$ endblock $} 


上 述 JavaScript 代码 执行 AJAX 请 求 ， 并 关注 /取消 关注 特定 用 户 ， 同 时 切换 关注 / 取 
消 关注 链接 。 这 里 采用 jQuery 执行 AJAX 请 求 ， 并 根据 之 前 的 值 设置 data-action 属性 和 
HTML <a> 元 素 的 文本 内 容 。 当 执行 AJAX 活动 时 , 还 将 更 新 显示 于 当前 页 面 上 的 全 部 关 
注 者 计数 。 打 开 现 有 用 户 的 用 户 详细 页 面 , 并 单 击 FOLLOW 链接 测试 刚刚 设置 的 功能 项 。 
我 们 将 会 看 到 ， 关 注 者 的 计数 结果 将 会 增加 ， 如 图 6.3 所 示 。 
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6.2 ”构建 通用 活动 流 应 用 程序 


许多 社交 网 站 均 会 向 用 户 显示 活动 流 ， 进 而 可 跟踪 其 他 用 户 在 当前 平台 上 的 活动 。 
活动 流 是 某 个 或 一 组 用 户 执行 的 近期 活动 列表 。 例 如 ，Facebook 的 News Feed 新闻 提 
要 ) 即 为 一 个 活动 流 ， 相 关 动 作 包括 : 用 户 义 收藏 了 图 像 Y, 或 者 用 户 义 关注 了 用 户 Y。 
本 节 将 尝试 构建 一 个 活动 流 应 用 程序 ， 以 使 每 个 用 户 可 看 到 其 所 关注 的 用 户 的 近期 交互 
行为 。 对 此 ， 需 要 定义 一 个 模型 ， 以 保存 站 点 用 户 的 执行 的 各 种 动作 ， 同 时 提供 一 种 较 
为 简单 的 方式 向 提要 中 添加 相关 动作 。 
在 当前 项 目 中 创建 一 个 新 的 名 为 actions 的 应 用 程序 ， 并 包含 以 下 命令 : 


Python manage.PY startapp actions 


“面向 settings.py 文件 的 INSTALLED APPS 设置 中 加 入 新 的 应 用 程序 , 并 在 项 目 中 
激活 该 应 用 程序 ， 如 下 所 示 : 

INSTALLED APPS = [ 
雪人 


'actions .apps.ActionsConfig', 


] 
在 actions 应 用 程序 的 models.py 文件 中 ， 添 加 下 列 代码 : 


from django.db import models 


class Action (models.Model): 

user = models.ForeignKey('auth.User', 
related name='actions'， 
db index=True, 
on delete=models .CASCADE) 

verb = models.CharField (max length=255) 

created = models.DateTimeField(auto now add=True, 

db index=True) 


class Meta: 
ordering = ('-created',) 
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上 述 代 码 展示 了 Action 模型 ， 并 用 于 存储 用 户 的 各 项 活动 。 该 模型 涵盖 了 以 下 字段 : 

user 表示 执行 当前 活动 的 用 户 ， 表 示 为 Django User 模型 的 ForeignKey。 

verb 描述 了 用 户 执行 的 相关 活动 。 

created 表示 活动 创建 的 日 期 和 时 间 。 当 对 象 首 次 保存 至 数据 库 中 时 ， 我 们 使 用 

auto_now_add=True 并 自动 将 其 设置 为 当前 日 期 。 
利用 上 述 基本 模型 ， 仅 可 设置 诸如 “用 户 X 执行 了 某 项 活动 ”这 一 类 操作 。 此 外 ， 

我 们 还 需要 一 个 附加 的 ForeignKey 字段 ， 进 而 保存 涉及 target 对 象 的 活动 ， 例 如 用 户 X 

收藏 了 图 像 Y， 或 者 用 户 X 当前 关注 了 用 户 Y。 如 前 所 述 ， 常 规 的 ForeignKey 仅 执行 一 

个 模型 相反, 我们 需要 一 种 方法 使 活动 的 target 对 象 成 为 现 有 模型 的 实例 , 这 也 是 Django 

内 容 类 型 框架 的 用 武之 地 。 


OODO 


6.2.1 使 用 contenttypes 框架 


Django 设置 了 位 于 django.contrib.contenttypes 的 contenttypes 框架 ， 该 应 用 程序 可 跟 
踪 安 装 在 项 目 中 的 全 部 模型 ， 并 提供 了 一 个 通用 接口 与 模型 进行 交互 。 

当 利用 startproject 创建 新 项 目 时 ， 默 认 状 态 下 ，django.contrib.contenttypes 应 用 程序 
包含 于 INSTALLED_APPS 设置 中 。 同 时 ， 该 应 用 还 可 供 其 他 contrib 包 使 用 ， 如 验证 框 
架 和 管理 应 用 程序 。 

contenttypes 应 用 程序 包含 了 ContentType 模型 。 该 模型 实例 体现 了 应 用 程序 的 实际 
模型 ， 当 在 项 目 中 安装 新 模型 时 ， 将 自动 生成 新 的 ContentType 实例 。ContentType 模型 

LL 含 下 列 字段 : 

口 app_label 表示 当前 模型 所 属 的 应 用 程序 名 称 ， 并 自动 从 模型 Meta 选项 的 

app_label 属性 中 得 到 。 如 Image 模型 隶属 于 images 应 用 程序 。 

口 、 model 表示 模型 类 的 名 称 。 

口 name 表示 人 们 可 读 的 模型 名 称 ， 并 自动 从 模型 Meta 选项 的 verbose_name 属性 
中 获得 。 

下 面 考察 如 何 与 ContentType 对 象 进行 交互 ,运行 python manage.py shell 命令 并 打开 
Shell， 通 过 执行 基于 app_label 和 model 的 查询 ， 可 获得 与 特定 模型 对 应 的 ContentType 
对 象 ， 如 下 所 示 : 

>>> from django.contrib.contenttypes.models import ContentType 

>>> image type = ContentType.objects.get (app_ label='images', model='image') 

>>> image type 

<ContentType: image> 
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此 外 ， 还 可 检索 源 自 ContentType 对 象 的 模型 类 ， 即 调用 其 model_class() 方 法 ， 如 下 


所 示 : 


作 。 
型 的 


862 


3 个 : 


>>> image type -model class () 
<class 'images.models.Image'> 


另外 ， 针 对 特定 模型 类 获得 ContentType 对 象 也 是 较为 常见 的 操作 ， 如 下 所 示 : 


>>> from images.models import Image 
>>> ContentType.objects.get for model (Image) 
<ContentType: image> 


一 些 示 例 较 好 地 展示 了 内 容 类 型 的 使 用 方式 ，Django 提供 了 多 种 方式 可 与 其 协同 工 
读者 可 访问 https://docs.djangoproject.com/en/2.0/ref/contrib/contenttypes/ 以 了 解 内 容 类 
官方 文档 。 


2 ”向 模型 中 添加 通用 关系 


在 通用 关系 中 ，ContentType 对 象 扮演 的 角色 用 于 指向 用 于 关系 的 模型 。 对 此 ， 需 要 

字段 设置 模型 中 的 通用 关系 ， 如 下 所 示 : 

口 “ContentType 的 ForeignKey 字段 ， 表 示 为 当前 关系 的 模型 。 

口 存储 关系 对 象 的 主键 的 字段 ， 通 常 是 PositiveIntegerField 以 匹配 Django 的 自动 
主键 字段 。 

口 在 上 述 两 个 字段 的 基础 上 ， 用 于 定义 和 管理 通用 关系 的 字段 。 内 容 类 型 框架 对 
此 提供 了 一 个 GenericForeignKey 字段 ， 如 下 所 示 : 

编辑 actions 应 用 程序 的 models.py 文件 ， 如 下 所 示 : 

from django.db import models 


from django.contrib.contenttypes.models import ContentType 
from django.contrib.contenttypes.fields import GenericForeignKey 


class Action (models.Model): 

user = models.ForeignKey('"auth.User' 
related name='actions'， 
db index=True, 
on delete=models .CASCADE) 

verb = models.CharField (max length=255) 

target ct = models.ForeignKey (ContentType, 

blank=True, 
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null=True, 
related name='target obj', 
on delete=models .CASCADE) 
target id = models.PositiveIntegerField(null=True, 
blank=True, 
db index=True) 
target = GenericForeignKey('target ct', 'target id') 
created = models.DateTimeField(auto now add=True, 
db index=True) 


class Meta: 
ordering = ('-created',) 


这 里 向 Action 模型 中 添加 了 下 列 字段 。 

口 target_ct:， 表示 为 一 个 ForeignKey 字段 ， 并 指向 ContentType 模型 。 

口 target_ id: 表示 为 一 个 存储 关系 对 象 主键 的 PositiveIntegerField。 

口 target: 在 上 述 两 个 字段 的 基础 上 ， 表 示 为 关系 对 象 的 GenericForeignKey 字段 。 

Django 并 不 会 针对 GenericForeignKey 在 数据 库 中 生成 任何 字段 ， 仅 target_ct 和 
target_ id 映射 至 数据 库 字 段 中 。 这 两 个 字段 均 包 含 了 blank=True 和 null=True 属性 。 因 而 
在 保存 Action 对 象 时 无 须 使 用 到 target 对 象 。 
© xs: 

在 有 意义 的 情况 下 ， 可 以 使 用 通用 关系 而 不 是 外 键 ， 从 而 使 应 用 程序 更 加 灵活 

运行 下 列 命令 ， 针 对 当前 应 用 程序 创建 初始 迁移 : 


Python manage.py makemigrations actions 


对 应 结果 如 下 所 示 : 


Migrations for 'actions': 
actions/migrations/0001 initial.py 
- Create model Action 


随后 ， 运 行 下 列 变量 将 应 用 程序 与 数据 库 同 步 : 
python manage.py migrate 


上 述 命令 的 输出 结果 表明 ， 迁 移 操作 已 执行 完毕 ， 如 下 所 示 : 


Applying actions.0001 initial... OK 


接 下 来 向 管理 站 点 添加 Action 模型 。 对 此 ， 编 辑 actions 应 用 程序 的 admin.py 文件 ， 
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并 向 其 中 添加 下 列 命 


from django .contrib import admin 
from .models import Action 


@admin.register (Action) 

class ActionAdmin (admin.ModelAdmin): 
list display = ('user', 'verb', 'target', 'created') 
list filter = ('created',) 
search fields = ('verb',) 


上 述 代 码 在 管理 站 点 中 注册 了 Action 模型 。 运 行 python manage.py runserver 命令 ， 
初始 化 开发 服务 器 ， 并 在 浏览 器 中 打开 http://127.0.0.1:8000/admin/actions/action/add/。 此 
时 ， 页 面 中 创建 了 一 个 新 的 Action 模型 ， 如 图 6.4 所 示 。 


[BJtelalelog: [ol lol dle WELCOME, ANTONIO. VIEW SITE / CHANGE 


Home » Actions » Actions ,Add action 
Add action 

User 

Target ct: 

Target id: 


Verb: 


Saveand add another Save and continue editing 


图 6.4 


从 图 6.4 中 可 以 看 到 ， 此 处 仅 显 示 了 映射 至 实际 数据 库 字段 的 target_ct 和 target id， 
GenericForeignKey 字段 并 未 在 表单 中 显示 。target_ ct 字段 可 选择 Django 项 目 中 任意 注册 
后 的 模型 。 另 外 ， 还 可 对 内 容 类 型 进行 限制 ， 并 通过 target ct 字段 中 的 limit_ choices to 
属性 从 限定 的 模型 集中 进行 选取 : limit choices to 属性 可 将 ForeignKey 字段 的 内 容 限 制 
为 某 个 特定 的 数值 集 。 

在 actions 应 用 程序 内 创建 新 文件 , 并 将 其 命名 为 utils.py。 我 们 将 定义 一 个 快捷 函数 ， 
并 以 简单 的 方式 生成 新 的 Action 对 象 。 对 此 ， 编 辑 新 的 utilspy 文件 ， 并 向 其 中 添加 下 列 
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代码 : 


from django.contrib.contenttypes.models import ContentType 
from .models import Action 


def create action(user, verb, target=None): 


action = Action(user=user, verb=verb, target=target) 
action.save() 


create_action(0) 函 数 可 创建 某 些 活动 ， 并 可 选择 地 包含 target 对 象 。 在 代码 中 ， 可 将 该 
函数 用 作 快 捷 方式 ， 以 向 活动 流 中 加 入 新 的 活动 。 


6.2.3 ”避免 活动 流 中 的 重复 内 容 


某 些 时 候 ， 用 户 可 能 会 多 次 执行 某 项 活动 ， 如 多 次 单 击 LIKE 或 UNLIKE 按钮 ;或 
者 在 较 短 时 间 内 多 次 执行 同一 项 活动 ， 这 将 导致 存储 、 显 示 重 复 的 活动 。 为 了 避免 这 
问题 ， 可 改进 create_action() 以 忽略 重复 的 活动 。 

编辑 actions 应 用 程序 的 utils.py 文件 ， 如 下 所 示 : 

import datetime 


from django.utils import timezone 


from django.contrib.contenttypes.models import ContentType 
from .models import Action 


def create action (user, verb, target=None): 
# check for any similar action made in the last minute 
now = timezone.now() 
last minute = now - datetime.timedelta(seconds=60) 
similar actions = Action.objects.filter (user id=user.id, 
Verb= verb, 
created gte=last minute) 
if target: 
target ct = ContentType.objects.get for model (target) 
similar actions = similar actions.filter!( 
target ct=target ct, 


target id=target.id) 
if not similar actions: 


# no existing actions found 


action = Action (user=user, verb=verb, target=target) 
action.save() 


值 ， 


6.2 


我 们 
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return True 
return False 


这 里 修改 了 create_action() 函 数 ， 以 避免 保存 重复 活动 ， 同 时 ， 该 函数 返 


以 显示 当前 活动 是 否 已 被 保存 。 下 列 内 容 显 示 了 如 何 避 人 免 重 复 行为 : 
口 首先 ， 利 用 Django 提供 的 timezonenow() 方 法 获取 当前 时 间 。 


SS 


本 一 个 布尔 


该 方法 执行 与 


datetime.datetime.now() 相 同 的 操作 ， 但 返回 一 个 timezone-aware 对 象 。Django 
提供 了 一 项 USE_TZ 设置 ， 以 启用 /禁用 时 区 功能 。 通 过 startproject 创建 的 默认 


settings.py 文件 包含 了 USE_TZ=True。 
口 ”利用 last_minute 变量 存储 1 分 钟 之 前 的 日 期 时 间 ， 并 检索 自 此 起 
同 操作 活动 。 


户 执行 的 相 


口 ” 如 果 最 后 1 分 钟 内 不 包含 相同 的 操作 活动 ， 则 创建 Action 对 象 。 若 Action 对 象 


已 被 创建 ， 则 返回 True， 和 否则 返回 False。 


.4 向 活动 流 中 添加 用 户 活动 


下 面向 视图 中 添加 某 些 操 作 活 动 ， 并 对 用 户 创建 活动 流 。 针 对 下 列 各 项 交互 行为 ， 


将 存储 对 应 的 操作 活动 : 

口 ”用户 收 藏 了 一 副 图 像 。 

口 ”用户 喜 爱 某 幅 图 像 。 

口 “用户 创建 了 一 个 账号 。 

日 、 用 户 关注 了 一 个 用 户 。 

编辑 images 应 用 程序 的 views.py 文件 ， 并 添加 下 列 导 入 语句 : 


from actions.utils import create action 


在 image_create 视图 中 ， 在 保存 图 像 后 添加 create_action()， 如 下 所 示 : 


new item.save () 
create action(request.user, 'bookmarked image', new item) 


在 image_like 视图 中 ,在 向 users_like 关系 添加 了 用 户 后 , 添加 create_action()， 如 下 
所 示 : 


image.users like.add(request.user) 
create action(request.user, 'likes', image) 


下 面 编 辑 zccount 应 用 程序 的 views.py 文件 ， 并 添加 下 列 导 入 语句 : 


from actions.utils import create action 
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Tn 


在 register 视图 


Ph， 在 创建 了 Profile 对 象 后， 添加 create_action0 如 下 所 示 : 


Profile.objects.create (user=new user) 
Create actionl(new user, 'has created an account') 


在 user follow 视图 中 ， 添 加 create_action0， 如 下 所 示 : 


Contact.objects.get or create (User from=request.user, 
user to=user) 
create action(request.user, 'is following', user) 


不 难 发 现 ， 基 于 Action 模型 和 帮助 函数 ， 可 简单 地 将 新 活动 保存 至 活动 流 中 。 


6.2.5 显示 活动 流 


最 后 ， 我 们 需要 一 种 方式 可 针对 每 个 用 户 显示 活动 流 。 对 此 ， 可 在 用 户 配置 中 包含 
活动 流 。 编 辑 account 应 用 程序 的 views.py 文件 ， 导 入 Action 模型 ， 并 修改 配置 视图 ， 
如 下 所 示 : 


from actions.models import Action 


@login required 
def dashboard (request): 
# Display all actions by default 
actions = Action.objects.exclude (user=request .user) 
following ids = request.user.following.values list('id', 
flat=True) 


if following ids: 
# If user is following others, retrieve only their actions 
actions = actions.filter(user id in=following ids) 
actions = actions[:10] 


return render (request, 
"account/dashboard.html', 
{'section': 'dashboard', 
'actions': actions}) 
上 述 代码 从 数据 库 中 检索 所 有 的 操作 活动 ， 但 不 包括 当前 用 户 执 行 的 操作 。 默 认 状 
态 下 ， 将 检索 全 部 平台 用 户 执行 的 最 近 活动 。 如 果菜 个 用 户 关 注 了 另 一 个 用 户 ， 将 限制 
查询 且 仅 检索 所 关注 用 户 所 执行 的 操作 活动 。 最 后 ， 还 需要 将 对 应 结果 限制 为 所 返回 的 


五 
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前 10 个 操作 活动 。 此 处 并 未 使 用 QuerySet 中 的 order by0， 其 原因 在 于 ， 仅 依赖 于 Action 
模型 中 Meta 选项 提供 的 默认 排序 顺序 。 由 于 在 Action 模型 中 设置 了 ordering = (-created',)， 
因而 将 显示 近期 的 操作 活动 。 


6.2.6 优化 涉及 关系 对 象 的 QuerySet 


每 次 检索 Action 对 象 时 ， 通 常会 访问 其 关联 的 User 对 象 ， 以 及 用 户 关联 的 Profile 
对 象 。 Django ORM 提供 了 一 种 简单 方式 ， 可 同时 检索 关系 对 象 ， 从 而 避免 了 额外 的 数据 
库 查 询 操作 。 

1. 使 用 select_related() 

Django 提供 了 名 为 select related0) 的 QuerySet 方法 ， 并 可 针对 一 对 多 关系 检索 关系 
对 象 ， 这 将 转换 为 单一 、 更 加 复杂 的 QuerySet， 但 在 访问 关系 对 象 时 可 避免 额外 的 查询 
行为 。select related 方法 针对 ForeignKey 和 OneToOne 字段 ， 其 工作 方式 可 描述 为 : 执 
行 一 个 SQL JOIN 操作 ， 并 包含 了 SELECT 语句 中 关系 对 象 的 字段 。 

当 使 用 select_related() 方 法 时 ， 可 编辑 下 列 代码 : 

actions = actions[:10] 

同时 向 所 用 字段 添加 select_related， 如 下 所 示 : 


actions = actions.select_related( 'user', 'user profile')[:10] 


此 处 使 用 user_profile 连接 单一 SQL 查询 中 的 Profile 表 。 如 果 调 用 了 select_related()， 
且 未 向 其 传递 任何 参数 ， 将 从 全 部 ForeignKey 关系 中 检索 对 象 。 一 般 情况 下 ， 总 是 将 
select_ related(O) 限 制 为 以 后 要 访问 的 关系 。 


人 @@ 注意， 


谨慎 使 用 select related() 可 以 大 大 提高 执行 时 间 。 


2. 使 用 select_related() 

当 检 索 一 对 多 关系 中 的 关系 对 象 时 ，select related0 可 对 性 能 提升 提供 较 好 的 帮助 。 
然而 ，select related() 并 不 适用 于 多 对 多 或 多 对 一 关系 〈ManyToMany 或 ForeignKey 反 向 
字段 ) 。Dijango 定义 了 一 种 名 为 prefetch related 的 不 同 的 QuerySet 方法 ， 并 适用 于 多 对 
多 或 多 对 一 关系 ， 以 及 select_related() 所 支持 的 关系 。prefetch_related() 方 法 针对 每 个 关系 
执行 独立 的 查询 ， 并 通过 Python 连接 结果 。 此 外 ， 该 方法 还 支持 GenericRelation 和 
GenericForeignKey 的 预 取 行 为 。 
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编辑 account 应 用 程序 的 views.py 文件 ， 对 于 GenericForeignKey 目标 字段 ， 通 过 添 
加 prefetch_ related(0) 实 现 查询 操作 ， 如 下 所 示 : 


actions = actions.select _ related('user'， "user profile')\ 


-Prefetch _ related('target')[:10] 


上 述 查 询 针 对 用 户 活动 的 检索 以 及 关系 对 象 进行 了 相应 的 优化 。 
6.2.7 ”针对 操作 活动 创建 模板 


下 面 创建 模板 并 显示 特定 的 Action 对 象 。 在 actions 应 用 程序 目录 创建 新 目录 ， 将 其 
命名 为 并 添加 下 列 结构 : 


actions/ 
action/ 
detail.html 


编辑 actions/action/detail.html 模板 文件 ， 并 向 其 中 添加 下 列 代 码 行 : 
{$ load thumbnail %} 


{s with user=action.user profile=action.user.profile %} 
<div class="action"> 


<div class="images"> 
{% if profile.photo %} 
{% thumbnail user.profile.photo "80x80" crop="100%" as im %} 
<a href="{{ user.get absolute Url }}"> 
<img src="{{ im.url }}" alt="{{ user.get full name }}" 
class="item-img"> 
</a> 
{s endthumbnail %} 
{ endif %} 
{% if action.target %} 
{g% with target=action.target %} 
{% if target.image %} 
{%$ thumbnail target.image "80x80" crop="100%" as im %} 
<a href="{{ target.get absolute url }}"> 
<img src="{{ im.url }}" class="item-img"> 
</a> 
{s endthumbnail %} 
{ 村 endif %} 
{S$ endwith %} 
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{Ss endif %} 
</div> 
<div class="info"> 
<p> 
<span class="date">{{ action.created|timesince }} ago</span> 
<br 
<a href="{{ user.get absolute url }}"> 
{{ user.first name }} 
</a> 
{{ action.verb }} 
{% if action.target %} 
{% with target=action.target %} 
<a href="{{ target.get absolute Url }}">{{ target }}</a> 
{S$ endwith %} 
{%$ endif %} 
</p> 
</div> 
</div> 
{S$ endwith %} 


上 述 模板 用 于 Action 对 象 。 首 先 使 用 了 {% with %} 模 板 标签 检索 用 户 执行 的 活动 以 
及 关联 的 Profile 对 象 。 随 后 ， 如 果 Action 对 象 包 含 关 联 的 target 对 象 ， 则 显示 target 对 
象 的 图 像 。 最 后 ， 还 将 显示 一 个 用 户 链接 ,该 用 户 执 行 了 当前 活动 、verb 以 及 target 对 象 
〈 若 存在 ) 。 

下 面 编辑 account 应 用 程序 的 account/dashboard.html 模板 ， 并 在 content 下 方 添加 下 
列 代码 ; 


<h2>What's happening</h2> 
<div id="action-list"> 
{$$ for action in actions %} 
{$$ include "actions/action/detail.html" %} 
{% endfor 要 } 
</div> 


在 浏览 器 中 打开 http://127.0.0.1:8000/account/， 利 用 已 有 账号 登录 并 执行 相关 操作 ， 
进而 将 结果 存储 于 数据 库 中 。 随 后 ， 利 用 另 一 个 账号 登录 ， 关 注 之 前 的 用 户 ， 并 查看 配 
置 页 面 中 生成 的 活动 流 ， 如 图 6.5 所 示 。 

上 述 内 容 针 对 用 户 创建 了 完整 的 活动 流 ， 进 而 可 方便 地 向 其 中 添加 新 用 户 。 除 此 之 
外 ， 还 可 向 活动 流 中 添加 翻 页 功能 ， 即 实现 与 image_list 视图 相同 的 分 页 器 。 
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What's happening 


: 


| S bookmarked image Tu 


图 6.5 


6.3 ”利用 信号 实现 反 规 范 化 计数 


在 茶 些 场合 下 ， 可 能 需要 对 数据 执行 反 规范 化 (denormalize〉 操作。 这 里 ， 反 规范 
化 是 一 种 数据 见 余 方式 ， 并 可 优化 读 取 性 能 。 我 们 需要 对 此 加 以 谨慎 处 理 ， 并 仪 在 需要 
时 对 其 予以 使 用 。 关 于 反 规范 化 ， 最 大 的 问题 来 自 难以 保持 反 规范 化 数据 的 更 新 。 

通过 反 规范 化 计数 结果 ， 本 节 将 考察 一 个 查询 性 能 改进 示例 ， 其 缺点 在 于 ， 需 要 保 
持 见 余数 据 的 更 新 状态 。 下 面 将 对 Image 模型 中 的 数据 执行 反 规 范 化 操作 , 并 通过 Django 
信号 使 数据 处 于 更 新 状态 。 


6.3.1 与 信号 协同 工作 


Django 内 置 了 信号 调度 器 ， 并 在 出 现 特定 操作 时 使 得 receiver 函数 获得 通知 。 对 于 
发 生 的 一 些 行为 ， 当 需要 代码 执行 相关 操作 时 ， 信 和 号 十 分 有 用 。 此 外 ， 也 可 创建 自己 的 
信号 并 在 事件 发 生 时 予以 通知 。 

Django 针对 模型 提供 了 多 种 信号 ， 且 位 于 django.db models.signals。 下 列 内容 列 举 了 
一 些 信和 号: 

口 ”在 调用 save() 方 法 之 前 或 之 后 ，pre_save 和 post_save 将 分 别 被 发 送 。 

口 ”在 调用 某 个 模型 或 QuerySet 的 delete() 方 法 之 前 或 之 后 ， 将 分 别 发 送 pre_delete 

和 post_delete。 
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口 ” 当 模型 上 的 ManyToManyField 产生 变化 后 ， 将 发 送 m2m_changed。 

这 表示 为 Django 所 提供 的 信号 子 集 。 读 者 可 访问 https://docs.djangoproject.com/en/2.0/ 
ref/signals/ 以 了 解 所 有 的 内 置信 号 列表 。 

假设 希望 根据 受 欢 迎 程度 检索 图 像 ， 对 此 ， 可 使 用 Django 的 聚合 函数 ， 并 根据 用 / 
的 喜好 数量 检索 图 像 。 回 忆 一 下 ， 第 3 章 曾 使 用 了 聚合 函数 。 下 列 代码 将 根据 喜好 数量 
检索 图 像 : 


from django.db.models import Count 
from images.models import Image 


images by popularity = Image.objects.annotate( 
total likes=Count('users like')).order by('-total likes') 


然而 ， 与 通过 某 个 字段 进行 排序 〈 存 储 了 总 计数 ) 相 比 ， 计 算 全 部 likes 对 图 像 进行 
排序 其 代价 相对 高 昂 。 这 里 ， 可 向 Image 模型 添加 一 个 字段 ， 并 反 规 范 化 全 部 喜好 数量 ， 
进而 提升 涉及 该 字段 的 查询 性 能 。 下 面 的 问题 则 是 ， 如 何 保持 该 字段 处 于 更 新 状态 ? 
编辑 images 应 用 程序 的 odels.py 文件 ， 并 向 Inage 模型 中 添加 下 列 total_likes 字段 ， 
class Image (models.Model): 
和 


total likes = models.PositiveIntegerField(db index=True, 
default=0) 


total likes 字段 将 存储 喜爱 每 幅 图 像 的 全 部 用 户 计数 。 当 希望 过 滤 或 排序 QuerySet 
时 ， 反 规范 化 计数 结果 十 分 有 用 。 
© 注意 ， 

在 对 相关 字段 执行 反 规 范 化 操作 时 ， 存 在 多 种 方式 可 改进 性 能 ， 我 们 需要 对 其 予以 考 
察 。 在 开始 对 数据 进行 反 规 范 化 操作 前 ， 应 考虑 数据 库 索 引 、 查 询 性 能 以 及 缓存 机 制 等 

在 向 数据 库 表 中 添加 新 字段 时 ， 运 行 下 列 命令 并 创建 迁移 结果 。 

Python manage.py makemigrations images 

对 应 输出 结果 如 下 所 示 : 


Migrations for 'images': 
images/migrations/0002 image total likes.py 
- Rdd field total likes to image 


随后 ， 运 行 下 列 命令 并 应 用 上 述 迁 移 结果 : 


python manage.py migrate images 
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对 应 输出 结果 如 下 所 示 : 

Applying images.0002 image total likes... OK 

下 面 将 receiver 函数 绑 定 至 m2m changed 信号 上 。 在 images 应 用 程序 目录 中 创建 新 
文件 ， 将 其 命名 为 signalspy， 并 向 其 中 添加 下 列 代码 : 


from django.db.models.signals import m2m changed 
from django.dispatch import receiver 
from .models import Image 


@receiver (m2m changed, sender=Image.users like.through) 
def users like changed(sender, instance, **kwargs): 
instance.total likes = instance.users like.count() 
instance.save() 
首先 ， 通 过 receiver() 装 饰 器 将 users_like_changed 函数 注册 为 receiver 函数 ， 同 时 将 
其 绑 定 至 m2m_changed 信号 上 。 我 们 将 该 函数 连接 至 Image.users like.through， 只 有 当 
m2m_changed 信号 由 该 发 送 方 发 出 时 才 调 用 该 函数 。 此 外 ，receiver 函数 的 注册 操作 还 存 
在 一 个 替代 方案 ， 并 采用 了 Signal 对 象 的 connect() 方 法 。 
© i: 
Django 信号 具有 同步 和 阻塞 特征 。 这 里 不 要 将 信号 与 异步 任务 混淆 。 但 是 ， 我 们 
可 结合 两 者 ， 并 在 代码 获得 某 个 信号 通知 时 启动 异步 任务 。 
此 外 ， 还 需要 将 receiver 函数 与 信号 进行 连接 ， 进 而 在 每 次 发 送信 号 时 调用 该 函数 。 
对 于 信号 的 注册 ， 一 种 推荐 的 方法 是 将 其 导入 至 应 用 程序 配置 类 的 ready0 方 法 中 。 对 此 ， 
Django 提供 了 一 个 应 用 程序 注册 表 ， 以 配置 和 查看 应 用 程序 。 


6.3.2 ”应 用 程序 配置 类 


Django 可 针对 应 用 程序 定义 配置 类 。 当 使 用 startapp 命令 创建 一 个 应 用 程序 时 ， 
Django 向 应 用 程序 目录 中 添加 了 一 个 apps.py 文件 , 同时 包含 了 继承 自 AppConfig 类 的 基 
本 应 用 程序 配置 。 
应 用 程序 配置 类 可 存储 元 数据 以 及 应 用 程序 的 配置 ， 同 时 提供 了 应 用 程序 的 内 查 功 
能 。 关 于 应 用 程序 的 配置 , 读者 可 访问 https://docs.djangoproject.com/en/2.0/ref/applications/ 
以 了 解 更 多 信息 。 

为 了 注册 信号 receiver 函数 , 当 使 用 receiver() 函 数 时 ,需要 在 应 用 程序 配置 类 的 ready() 
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方法 中 导入 应 用 程序 的 信号 模块 。 一 旦 应 用 程序 注册 表 设 置 完毕 ， 即 会 调用 此 方法 。 另 
外 ， 应 用 程序 的 其 他 初始 化 工作 也 应 在 该 方法 内 完成 。 
编辑 images 应 用 程序 的 apps.py 文件 ， 如 下 所 示 : 


from django.apps import AppConfig 


class ImagesConfig (AppConfig): 
name = "images'" 


def ready (self): 
# import signal handlers 
import images.signals 


下 面 将 应 用 程序 的 信号 导入 ready0 方 法 中 ， 以 便 加 载 images 应 用 程序 时 导入 信和 号。 

利用 下 列 命令 运行 开发 服务 器 : 

python manage.py runserver 

打开 浏览 器 查看 图 像 详细 页 面 ， 并 单 击 LIKE 按钮 。 随 后 返回 至 管理 站 点 , 浏览 并 编 
辑 URL, 如 http://127.0.0.1:8000/admin/images/image/1/change/， 同时 考 


戎 察 total likes 属性 。 
其 中 ，total_likes 属性 通过 喜爱 该 幅 图 像 的 用 户 总 量 实现 了 更 新 操作 ， 如 图 6.6 所 示 。 


Users like: 


Total likes: 


图 6.6 
当前 , 可 使 用 total_likes 属性 并 通过 受 欢 迎 程度 对 图 像 进行 排序 , 或 者 于 某 处 显示 图 像 ， 
从 而 避免 了 复杂 的 查询 、 计 算 工 作 。 下 列 代码 实现 了 根据 like 计数 排序 后 的 图 像 查 询 操 作 : 


from django.db.models import Count 


images by popularity = Image.objects.annotate( 
likes=Count ('users like')) .order by('-likes') 
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上 述 查 询 操作 也 可 采用 下 列 方式 编写 : 

images by popularity = Image.objects.order by('-total likes') 

上 述 结果 是 一 类 开销 较 小 的 SQL 查询 操作 ， 同 时 也 体现 了 Django 信号 的 应 用 方式 。 
©@ :ia: 

我 们 应 谨慎 使 用 信号 。 信 和 号 使 得 了 解 控制 流 变 得 较为 困难 。 大 多 数 时 候 ， 如 果 已 知 
晓 通 知 哪些 接收 者 ， 就 可 以 避免 使 用 信号 。 

相应 地 ， 需 要 设置 初始 计数 以 匹配 数据 库 的 当前 状态 。 对 此 ， 利 用 python manage.py 
shell 命令 打开 Shell， 并 运行 下 列 代 码 : 


from images.models import Image 

for image in Image.objects.all(): 
image.total likes = image.users like.count() 
image.save() 


随后 ， 每 幅 图 像 的 likes 计数 将 被 更 新 。 


6.4 利用 Redis 存储 数据 项 视图 


Redis 是 一 种 高 级 的 键 / 值 型 数据 库 ， 可 存储 不 同 的 数据 类 型 ， 且 实现 了 快速 的 IO 操 
作 。Redis 将 数据 存储 于 内 存 中 ， 但 可 通过 每 隔 一 段 时 间 将 数据 集 转 储 到 磁盘 ， 或 将 每 个 
命令 添加 到 日 志 中 来 实现 数据 的 持久 化 。 与 其 他 键 / 值 存储 相 比 ，Redis 非常 灵活 : 它 提供 
了 一 组 强大 的 命令 ， 并 支持 各 种 数据 结构 ， 如 字符 串 、 哈 希 、 列 表 、 集 合 、 有 序 集 ， 甚 
至 位 图 或 HyperLogLogs。 

虽然 SQL 最 适合 于 模式 定义 的 持久 数据 存储 ， 但 在 处 理 快速 变化 的 数据 、 易 失 性 存 
储 或 需要 快速 缓存 时 ，Redis 依然 具备 许多 优势 。 


6.4.1 安装 Redis 


读者 可 访问 https://redis.io/download 下 载 最 新 版 本 的 Redis。 解压 tar.gz 文件 后 , 输入 
redis 目录 并 利用 make 目录 编译 Redis， 如 下 所 示 : 


cd redis-4.0.9 
make 


在 Redis 安装 完毕 后 ， 使 用 下 列 Shell 命令 初始 化 Redis 服务 器 : 


src/redis-server 
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对 应 输出 结果 如 下 所 示 : 


# Server initialized 
* Ready to accept connections 


默认 状态 下 ，Redis 运行 于 6379 端口 上 上。 通过--port 标记 ， 还 可 自 定义 端口 ， 如 
redis-server --port 6655 。 

令 Redis 处 于 运行 状态 ， 同 时 打开 Shell。 利 用 下 列 命 令 启 动 Redis 客户 端 ; 

src/redis-cli 

Redis 客户 端 Shell 提示 符 如 下 所 示 : 


127.0.0.1:6379> 


Redis 客户 端 可 直接 从 Shell 中 执行 Redis 命令 ， 下 面 对 此 予以 尝试 。 在 Redis Shell 
中 输入 SET 命令 ， 并 将 值 存储 于 键 中 ， 如 下 所 示 : 

127.0.0.1:6379> SET name "Peter" 

OK 


上 述 命令 在 Redis 数据 库 中 利用 字符 串 值 Peter 生成 了 一 个 name 键 。 输 出 结果 OK 
表示 该 键 已 被 成 功 地 保存 。 接 下 来 ， 利 用 GET 命令 检索 该 值 ， 如 下 所 示 : 

127.0.0.1:6379> GET name 

"Reteey 


除 此 之 外 ， 还 可 通过 EXISTS 检查 某 个 键 是 否 存在 。 如 果 键 存在 ， 则 返回 1， 否则 返 
回 0， 如 下 所 示 : 

127.0.0.1:6379> EXISTS name 

(integer) 1 

另外 ， 还 可 以 使 用 EXPIRE 命令 设置 键 过 期 的 时 间 ， 该 命令 允许 用 户 以 秒 为 单位 设 
置 时 间 。 另 一 个 选项 则 是 使 用 EXPIREAT 命令 ， 它 需要 一 个 Unix 时 间 戳 。 当 使 用 Redis 
作为 缓存 或 存储 易 失 数据 时 ， 键 过 期 设置 将 变 得 十 分 有 用 ， 如 下 所 示 : 

127.0.0.1:6379> GET name 

六 

127.0.0.1:6379> EXPIRE name 2 

(integer) 1 

在 等 待 两 秒 后 ， 再 次 尝试 获取 同一 个 键 ， 如 下 所 示 : 


127.0.0.1:6379> GET name 
(nil) 
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其 中 ，(nij) 响 应 表示 空 响应 ， 表 示 未 发 现 对 应 键 。 此 外 ， 还 可 使 用 DEL 命令 删除 键 ， 
如 下 所 示 : 

127.0.0.1:6379> SET total 1 

OK 

127.0.0.1:6379> DEL total 

(integer) 1 

127.0.0.1:6379> GET total 

(nil) 


上 述 内 容 展 示 了 基本 的 键 操作 命令 。 对 应 其 他 数据 类 型 ， 如 字符 串 、 哈 希 、 集 合 以 
及 有 序 集 ，Redis 同样 涵盖 了 大 量 的 命令 集 。 读 者 可 访问 https://redis.io/commands 查看 全 
部 Redis 命令 ， 还 可 访问 https://redis.io/topics/data-types 以 了 解 所 有 的 Redis 数据 类 型 。 


6.4.2 ”结合 Python 使 用 Redis 


这 里 ， 我 们 需要 将 Python 绑 定 至 Redis 中 。 对 此 ， 可 利用 下 列 命令 并 通过 pip 安装 
redis-py: 
pip install redis==2.10.6 


读者 可 访问 https://redis-py.readthedocs.io/ 以 查看 redis-py 的 相关 文档 。 

对 于 Redis 交互 行为 ,redis-py 包 提 供 了 两 个 类 ， 即 StrictRedis 和 Redis， 二 者 均 提供 
了 相同 的 功能 。 其 中 ，StrictRedis 类 遵循 官方 制定 的 Redis 命令 语法 ， 而 Redis 类 则 扩展 
了 StrictRedis， 并 履 写 了 其 中 的 某 些 方法 ， 进 而 提供 了 后 向 兼容 特性 。 由 于 StrictRedis 遵 
循 Redis 命令 语法 ， 因 而 此 处 将 使 用 StrictRedis。 打 开 Python Shell 并 执行 下 列 代码 : 

>>> import redis 

>>> r = Ledis.StrictRedis (host='localhost', port=6379, db=0) 


上 述 代码 生成 了 与 Redis 数据 库 的 连接 。 在 Redis 中 ， 数 据 库 通过 一 个 整数 索引 加 以 
标识 ， 而 非 数据 库 名 称 。 默 认 状 态 下 ， 客 户 端 将 连接 至 数据 库 0。 当 前 ，Redis 数据 库 的 
数量 设置 为 16， 当 然 也 可 在 redis.conf 配置 文件 中 对 此 进行 修改 。 

下 面 利 用 Python Shell 设置 键 ， 如 下 所 示 : 


>>> r.set('foo', 'bar') 
True 


上 述 命 令 返 回 True， 表 示 已 经 成 功 地 生成 了 键 。 随 后 ， 可 利用 get0 命 令 对 该 键 进行 


>>> r.get('foo') 
b'bar' 
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在 上 述 代 码 中 可 以 看 到 ，StrictRedis 中 的 方法 使 用 了 Redis 命令 语法 。 
下 面 将 Redis 整合 至 当前 项 目 中 。 对 此 ， 编 辑 bookmarks 项 目 中 的 settings.py 文件 ， 
并 向 其 中 添加 下 列 设置 内 容 : 


REDIS HOST = "localhost" 
REDIS PORT = 6379 
REDIS DB = 0 


上 述 内 容 表示 为 Redis 服务 器 的 设置 ， 以 及 将 用 于 项 目 中 的 数据 库 。 
6.4.3 ”将 数据 视图 存储 于 Redis 中 


本 节 将 讨论 一 种 方法 ， 进 而 存储 查看 一 幅 图 像 的 全 部 次 数 。 如 果 采 用 Django ORM 
实现 这 一 任务 ， 每 次 显示 图 像 时 将 涉及 SQL UPDATE 查询 操作 。 如 果 采 用 Redis， 仅 需 
增加 存储 在 内 存 中 的 计数 器 即 可 ， 这 可 有 效 地 提升 性 能 并 减少 开销 。 

下 面 编 辑 images 应 用 程序 的 views.py 文件 , 并 在 现 有 的 import 语句 后 添加 下 列 代码 ; 

import redis 

from django.conf import settings 


# connect to redis 

r= redis.StrictRedis (host=settings.REDIS HOST, 
port=settings.REDIS PORT, 
db=settings.REDIS DB) 


利用 上 述 代 码 , 可 建立 Redis 连接 , 并 在 当前 视图 中 对 其 加 以 使 用 。 编辑 image_detail 
视图 ， 如 下 所 示 : 


def image detail(request, id, slug): 
image = get object or 404(Image, id=id, slug=slug) 
# increment total image views by 1 
total views = r.incr('image:{}:views'.format (image.id)) 
return render (request, 
'images/image/detail.html', 
{'section': 'images', 
'image': image, 
'total views': total views}) 

在 该 视图 中 ,使 用 了 incr 命令 将 既定 键 值 增加 1。 如 果 该 键 并 不 存在 ，incr 将 先期 对 
其 予以 创建 。 在 执行 了 此 类 操作 后 ，incr0 返 回 最 终 的 键 值 还 可 将 该 值 存储 于 total_views 
变量 中 ， 并 将 其 传递 至 模板 环境 中 。 同 时 ， 还 使 用 了 某 个 符号 创建 Redis 键 ， 如 object- 
type:id:field( 形 如 image:33:id) 。 
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@ 注意 : 

Redis 键 的 命名 约定 使 用 冒号 作为 分 隔 符 来 创建 带 有 名 称 空间 的 键 。 据 此 ， 键 名 较 
为 宛 长 ， 且 关联 键 包 含 了 名 称 中 的 部 分 相同 模式 ， 

编辑 images 应 用 程序 的 images/image/detailhtml 文件 ， 并 在 现 有 的 <span class="count"> 
元 素 后 添加 下 列 代 码 : 

<span class="count"> 


{{ total views }} view{{ total views|lpluralize }} 
</span> 


在 浏览 器 中 打开 详细 页 面 ， 并 对 其 重 载 多 次 。 每 次 处 理 视 图 时 ， 所 显示 的 全 部 视图 
数量 将 增加 1， 如 图 6.7 所 示 。 


Django and Duke 


Django and Duke image. 


Nobody likes this image yet. 


图 6.7 
至 此 ， 我 们 已 经 成 功 地 在 项 目 之 后 整合 了 Redis， 进 而 可 存储 数据 项 计数 结果 。 


6.4.4 ”将 排名 结果 存储 于 数据 库 中 


本 节 利 用 Redis 实现 较为 复杂 的 任务 , 并 生成 一 个 图 像 的 浏览 数量 排名 系统 。 当 构建 
这 一 排名 系统 时 ， 可 利用 Redis 存储 有 序 集 。 这 里 ， 有 序 集 表 示 为 一 个 非 重复 的 字符 串 集 
合 ， 其 中 ， 每 个 数字 与 一 个 积分 值 关 联 ， 而 对 应 条 目 则 通过 其 积分 值 进行 排序 。 

编辑 images 应 用 程序 的 views.py 文件 ， 并 向 image_detail 视图 中 添加 下 列 内 容 : 


def image detail (request, id, slug): 
image = get object or 404(Image, id=id, slug=slug) 
# increment total image views by 1 
total views = r.incr('image:{}:views'.format (image.id)) 
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# increment image ranking by 1 
r.zincrby('image ranking', image.id, 1) 
return render(request, 
'images/image/detail.html', 
{'section': 'images', 
'image': image, 
'total views': total views}) 

我 们 使 用 zincrby0 命 令 将 图 像 视图 存储 至 包含 image:ranking 键 的 有 序 集中 。 此 处 将 
存储 图 像 id 和 一 个 关联 的 积分 值 1， 它 将 被 添加 到 有 序 集中 该 元 素 的 总 积分 中 。 这 可 通 
过 全 局 方式 跟踪 全 部 图 像 视 图 ， 并 包含 一 个 以 全 部 视图 数量 排序 的 有 序 集 。 

下 面 创建 一 个 新 的 视图 ， 并 显示 浏览 量 最 多 的 图 像 排 名 结果 。 对 此 ， 向 images 应 用 
程序 的 views.py 文件 中 添加 下 列 代码 : 

@login required 

def image ranking (request): 

# get image ranking dictionary 
image ranking = r.zrange('image ranking', 0, -1, 
desc=True) [:10] 
image ranking ids = [int(id) for id in image ranking] 
# get most viewed images 
most viewed = list(Image.objects.filter( 
id in=image ranking ids)) 
most viewed.sort (key=lambda x: image ranking ids.index (x.id)) 
return render (request, 
'images/image/ranking.html', 
{'section': 'images', 
'most viewed': most viewed}) 

image_ranking 视图 工作 方式 如 下 : 

(1) 使 用 zrange0O 命 令 获 取 有 序 集中 的 元 素 ， 该 命令 根据 最 低 和 最 高 积分 值 使 用 了 
一 个 自 定义 范围 。 具 体 来 说 ， 使 用 0 作为 最 低 值 ， 使 用 -1 作为 最 高 积分 值 ， 并 通知 Redis 
返回 有 序 集中 的 全 部 元 素 。 此 类 ， 还 定义 了 desc=True 检索 降序 排序 的 元 素 。 最后， 通过 
[:10] 获 取 较 高 积分 值 的 前 10 个 元 素 。 

(2) 构建 一 个 返回 后 的 图 像 了 D 列表 ， 并 作为 整数 列表 将 其 存储 至 image_ranking ids 
中 。 随 后 针对 此 类 ID 检索 Image 对 象 ， 并 强制 查询 操作 通过 list0 函 数 执行 。 此 处 ， 需 要 
强制 QuerySet 执行 ， 其 原因 在 于 ， 当 前 使 用 了 其 上 的 sortO 列 表 方 法 〈 因 而 需要 使 用 到 
个 对 列表 ， 而 非 QuerySet) 。 

(3) 通过 图 像 排名 中 的 索引 对 象 Image 进行 排序 。 随 后 ， 使 用 模板 中 的 most_viewed 
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列表 显示 10 幅 最 常 被 浏览 的 图 像 。 
在 images 应 用 程序 的 images/image/ 模 板 目录 中 创建 ranking html 模板 ， 并 向 其 中 添 
加 下 列 代码 : 


{$$ extends "base.htm]l™ $%} 


{s block title %}Images ranking{% endblock %} 


{% block content $%} 
<hl>Images ranking</h1> 
<ol> 
{% for image in most viewed %} 
<1i> 
<a href="{{ image.get absolute url }}"> 
{{ image.title }} 
</a> 
> 
{ endfor %} 
</ol> 
{% endblock %} 


上 述 模板 内 容 较为 直观 。 代 码 遍历 most_viewed 列表 中 的 Image 对 象 , 并 显示 其 名 称 ， 
同时 还 包含 了 一 个 指向 图 像 详 细 页 面 的 链接 。 

最 后 ， 还 需要 针对 新 视图 创建 一 个 URL 路 径 。 对 此 ， 编 辑 images 应 用 程序 的 urls.py 
文件 ， 并 向 其 中 添加 下 列 路 径 : 

path('ranking/', views.image ranking, name='create'), 

运行 开发 服务 器 ， 在 Web 浏览 器 中 访问 站 点 ， 并 针对 不 同 的 图 像 多 次 加 载 图 像 。 随 后 ， 
在 浏览 器 中 访问 http://127.0.0.1:8000/images/ranking/, 图 6.8 显示 了 相应 的 图 像 排 名 结果 。 


Bookmarks 


Images ranking 
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至 此 ， 我 们 利用 Redis 创建 了 排名 系统 。 


6.4.5 ”Redis 特性 


Redis 并 不 是 SQL 的 蔡 代 产物 ， 其 体征 主要 体现 在 快速 存储 ， 并 适用 于 某 些 特定 任 
务 。 必 要 时 ， 可 将 Redis 中 加 入 开发 栈 中 并 对 其 加 以 使 用 。 

下 列 内 容 展示 了 Redis 的 一 些 使 用 场合 : 

口 计数 机 制 。 如 前 所 述 ， 可 通过 Redis 方便 地 管理 计数 器 。 对 此 ， 可 使 用 incr0 和 
incrby()。 
口 ”最初 近 期 数据 项 。 利 用 jpushO0 和 rpush0) 可 向 列表 的 开始 /结尾 处 添加 数据 项 ， 使 
用 lpop0/rpop0 移 除 和 返回 首 / 尾 元 素 ; 利用 ltrim0O) 调 整 列表 长 度 ， 进 而 对 其 长 度 
进行 维护 。 

口 队列 。 除 了 push 和 pop 命令 之 外 ，Redis 还 设置 了 阻塞 队列 命令 。 
口 “ 缓 存 机 制 。expire0 和 expireat(O) 可 将 Redis 用 作 缓 存 。 此 外 ， 针 对 Django， 我 们 

还 可 获得 第 三 方 Redis 缓存 后 台 程 序 。 

口 pub/sub。 针 对 订阅 /取消 订阅 操作 ， 以 及 如 何 将 消息 发 送 至 通道 中 ，Redis 也 提 

供 了 相关 命令 。 

口 ” 排 名 机 制 和 积分 榜 。Redis 有 序 集 可 方便 地 创建 积分 榜 。 
口 ” 实 时 跟踪 。Redis 的 快速 VO 存储 特别 适用 于 某 些 实时 场景 。 


6.5 本 章 小 结 


本 章 讨论 了 如 何 构建 关注 系统 和 用 户 活动 流 。 此 外 ， 我 们 还 学 些 了 Django 信号 的 工 
作 方 式 ， 以 及 如 何 将 Redis 整合 至 项 目 中 。 

第 7 章 将 介绍 如 何 搭建 在 线 商店 。 届 时 将 创建 一 个 商品 目录 ， 并 通过 会 话 创建 购物 
车 。 此 外 ， 我 们 还 将 学 习 如 何 利用 Celery 启动 异步 任务 。 
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第 6 章 创建 了 关注 系统 以 及 用 户 活 动 流 ， 同 时 还 学 习 了 Django 信号 的 工作 方式 ， 以 
及 如 何 将 Redis 整合 至 项 目 中 进而 对 图 像 视图 进行 计数 。 本 章 将 介绍 如 何 搭建 基本 的 在 线 
商店 。 我 们 将 构建 一 个 商品 目录 ， 并 利用 Django 会 话 实现 购物 车 功能 。 此 外 ， 本 章 还 将 
阐述 如 何 创建 自 定义 上 下 文 处 理 器 ， 并 通过 Celery 启动 异步 任务 。 

本 章 主要 涉及 以 下 内 容 

口 ”创建 商品 目录 。 

口 ”利用 Django 会 话 实现 购物 车 功能 。 

口 管理 客户 订单 。 

口 理由 Celery 向 客户 发 送 异 步 通知 。 


7.1 创建 在 线 商 店 项 目 


本 章 着 手 创建 新 的 Django 项 目 ， 并 尝试 构建 在 线 商店 。 其 中 ， 用 户 应 能 够 浏览 商品 
目录 ， 并 将 商品 添加 至 购物 车 中 。 最 后 ， 用 户 将 对 购物 车 中 的 商品 结账 并 生成 订单 。 本 
章 将 讨论 在 线 商店 的 下 列 各 项 功能 : 

口 ”创建 商品 目录 模型 ， 将 其 添加 至 管理 站 点 中 ， 并 创建 基本 视图 以 显示 商品 目录 。 

口 ”利用 Django 会 话 开发 购物 车 系统 ， 并 允许 用 户 在 浏览 网 站 时 保存 所 选 的 商品 。 

口 ”创建 表单 以 及 相关 功能 ， 并 在 网 站 中 生成 订单 。 

口 ”生成 订单 后 ， 向 用 户 发 送 异步 配置 消息 (通过 电子 邮件 〉。 

打开 Shell， 针 对 新 项 目 创 建 虚拟 环境 ， 并 利用 下 列 命 令 将 其 激活 : 

mkdir env 


Virtualenv env/myshop 
source env/myshop/bin/activate 


利用 下 列 命令 在 虚拟 环境 中 安装 Django: 
pip install Django==2.0.5 


打开 Shell 并 运行 下 列 命令 ， 利 用 shop 应 用 程序 启动 myshop 新 项 目 。 
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django-admin startproject myshop 
cd myshop/ 
django-admin startapp shop 


编辑 项 目的 settings.py 文件 ， 并 向 INSTALLED_APPS 设置 中 添加 shop 应 用 程序 ， 
如 下 所 示 : 
INSTALLED APPS = [ 


3 
'shop.apps.ShopConfig', 


| 
当前 ， 应 用 程序 针对 项 目 出 于 活动 状态 ， 下 面 定 义 商 品 模型 。 


7.1.1 创建 商品 目录 模型 


在 线 商店 的 目录 包含 了 隶属 于 不 同 的 目录 的 各 种 商品 ， 每 种 商品 分 别 包含 名 称 、 可 
选 的 描述 内 容 、 可 选 的 图 像 信息 、 价 格 以 及 存货 状态 。 对 此 ， 编 辑 shop 应 用 程序 的 
models.py 文件 ， 并 添加 下 列 代码 ; 


from django.db import models 


class Category (models.Model): 
name = models.CharField (max length=200, 
db index=True) 
slug = models.SlugField (max length=200, 
unique=True) 


class Meta: 
ordering = ('name',) 
Verbose name = "category'" 
verbose name plural = 'categories' 


def Er Tosilt)s 
return self.name 


class Product (models.Model) : 
category = models.ForeignKey (Category, 
related name="'products', 
on delete=models .CASCADE) 
name = models.CharField(max length=200, db index=True) 
slug = models.SslugField (max length=200, db index=True) 
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image = models.ImageField(upload to='products/SY/Sm/Ssd'， 
blank=True) 

description = models.TextField (blank=True) 

price = models.DecimalField (max digits=10, decimal places=2) 

available = models.BooleanField (default=True) 

created = models.DateTimeField(auto now add=True) 

updated = models.DateTimeField (auto now=True) 


class Meta: 
ordering = ('name',) 
index together = (('id'’, 'slug'),) 


def str (self): 
return self.name 


上 述 代 码 定义 为 Category 和 Product 模型 。 其 中 ，Category 模型 包含 了 name 字段 以 
及 唯一 的 slug 字段 〈 这 里 ，“ 唯 一 ” 意 指 生成 的 索引 ) 。 了 Product 字段 则 涵盖 以 下 内 容 。 


口 


回回 好 刁 各 


口 
口 


category: 表示 为 Category 模型 的 ForeignKey， 并 体现 了 一 种 多 对 一 的 关系 : 

件 商 品 隶属 于 某 个 牡 蝶 ， 而 一 个 目录 则 包含 了 多 件 商品 。 

name: 表示 商品 的 名 称 。 

slug: 用 于 生成 友好 的 URL。 

image: 表示 为 可 选 的 商品 图 像 。 

description: 表示 可 选 的 商品 描述 内 容 。 

price: 该 字段 使 用 了 Python 中 的 decimal.Decimal 类 型 存储 有 限 精 度 的 小 数 。 其 
中 ， 最 大 位 数 〈 包 括 小 数位 ) 由 max_digits 属性 以 及 基于 decimal places 属性 的 
小 数位 设置 。 

available: 定义 为 一 个 布尔 值 ， 表 明 商 品 的 存货 状态 (是 否 有 货 ) ， 同 时 启用 / 
禁用 目录 中 的 商品 。 

created: 该 字段 存储 对 象 创建 时 间 。 

updated: 该 字段 存储 对 象 最 后 一 次 更 新 的 时 间 。 


对 于 price 字段 ， 我 们 采用 了 DecimalField 而 非 FloatField， 以 避免 舍 入 误差 问题 。 


全 注意 ， 


一 般 使 用 DecimalField 存储 货币 金额 。FloatField 使 用 了 Python 中 的 float 类 型 ; 而 
DecimalField 则 使 用 了 Python 中 的 Decimal 类 型 。 通 过 Decimal 类 型 ， 可 消除 float 的 使 
入 误差 问题 。 

在 Product 模型 的 Meta 类 中 ， 我 们 采用 了 index_together 元 选项 指定 id 和 slug 字段 
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的 索引 。 该 索引 的 原因 在 于 : 这 里 将 通过 id 和 slug 对 商品 进行 查询 。 两 个 字段 
使 eg 
考虑 到 将 处 理 模 型 中 的 图 像 ， 可 打开 Shell 并 通过 下 列 命令 安装 Pillow: 


Pip install Pillow==5.1.0 


运行 下 列 命令 ， 并 生成 项 目的 初始 


Python manage.py makemigrations 
对 应 输出 结果 如 下 所 示 : 


Migrations for 'shop': 
shop/migrations/0001 initial.py 
- Create model Category 
- Create model Product 
- Alter index together for product (1 constraint(s)) 


运行 下 列 命令 同步 数据 库 


python manage.py migrate 
对 应 输出 结果 如 下 所 示 : 


Applying shop.0001 initial... OK 


3 


NE 


1 前 ， 数 据 库 与 模型 处 于 同步 状态 。 
7.1.2 ”注册 站 点 上 的 目录 模型 


下 面向 管理 站 点 中 添加 模型 ， 进 而 可 方便 地 管理 目录 和 商品 。 编 辑 shop 应 用 程序 的 
admin.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django .contrib import admin 
from .models import Category, Product 


@admin.register (Category) 

class CategoryAdmin (admin.ModelAdmin): 
list display = ['name', 'slug'] 
prepopulated fields = {'slug': ('name',)} 


@admin.register (Product) 
class ProductAdmin (admin.ModelAdmin): 
list display = ['name', 'slug', 'price', 
"available'， 'created', "updated'] 
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list filter = ['available', 'created', "updated'] 
list editable = ['price', 'available'] 
prepopulated fields = {'slug': ('name',)} 

记 住 ， 我们 使 用 prepopulated_fields 属性 指定 某 些 字段 ， 其 中 对 应 值 利 用 其 他 字段 值 
动 设置 。 如 前 所 述 ， 这 可 便于 生成 sug。 另 外 ，ProductAdmin 类 中 使 用 了 list_editable 
属性 ， 并 可 一 次 编辑 多 行内 容 。 由 于 仅 显示 的 字段 方 可 被 编辑 ， 因 而 list_editable 中 的 任 
意 字 段 也 需要 在 list_display 属性 中 列 出 。 

下 面 针对 当前 站 点 创建 一 个 超级 用 户 ， 并 使 用 下 列 命 


Python manage.PY createsuperuser 


利用 python manage.py runserver 命令 启动 开发 服务 器 ， 在 浏览 器 中 打开 http://127.0.0.1: 
8000/admin/shop/product/add/， 并 利用 创建 的 账户 登录 。 随 后 ， 通 过 管理 界面 添加 新 的 目 
录 和 商品 。 图 7.1 显示 了 商品 变化 列表 页 面 〈 位 于 管理 页 面 中 ) 。 


Django administration 


Home ,Shop Produsts 


© The product "Green les' was added successfuly 


Select product to change 


utAatE CAEATED UpoATED 


Deec.5,2017,617pm, Dec 5 2017. 617pm 


7.1.3 构建 目录 视图 


为 了 显示 商品 目录 ， 需 要 创建 一 个 视图 以 显示 全 部 商品 ， 或 者 根据 给 定 目录 过 滤 商 
品 。 对 此 ， 编 辑 shop 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 
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from django .shortcuts import render, get object or 404 
from .models import Category, Product 


def product list(request, category slug=None): 
Category = None 
categories = Category.objects.all () 
products = Product.objects.filter (available=True) 
if category slug: 


category = get object or 404(Category, slug=category slug) 
products = products.filter (category=category) 
return render(request, 

'shop/product/list.html', 

{'category': category, 

"categories': categories, 

'products': products}) 


我 们 将 利用 available=True 过 滤 QuerySet， 并 仅 对 有 货 产品 进行 检索 。 同 时 ， 还 使 用 
了 可 选 的 category_slug， 并 有 选择 地 根据 给 定 目录 过 滤 商 品 。 


除 此 之 外 ， 还 需要 一 个 视图 检索 并 显示 一 件 商品 。 相 应 地 ， 可 向 views.py 文件 添加 
下 列 视图 : 


def product detail (request, id, slug): 
product = get object or 404(Product, 
id=id, 
slug=slug, 


available=True) 
return render (request, 


'shop/product/detail.html', 
{'product': product}) 


product_detail 期 望 接收 id 和 slug 参数 ， 进 而 检索 Product 实例 。 鉴 于 ID 定义 为 唯一 
属性 ， 因 而 可 以 此 获得 该 实例 。 然 而 ， 我 们 将 在 URL 中 包含 slug， 并 针对 商品 生成 SEO 
友好 的 URL。 

在 生成 了 商品 列表 和 详细 页 面 后 ， 还 需 对 其 定义 URL 路 径 。 对 此 ， 可 在 shop 应 
程序 目录 中 创建 新 文件 ， 将 其 命名 为 urls.py 并 添加 下 列 代码 : 


from django.urls import path 
from . import views 


app name = 'shop"' 


urlpatterns = [ 
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path('', views.product list, name="'product list'), 
path('<slug:category slug>/', views.product list, 
name="'product list by category'), 
path('<int:id>/<slug:slug>/', views.product detail, 
name="'product detail'), 
] 


上 述 代 码 表示 为 商品 目录 的 URL 模式 。 此 处 针对 product_list 视图 定义 了 两 个 不 同 的 
URL 模式 ， 即 名 为 product_ list 的 模式 ， 该 模式 调用 product list 视图 且 不 需要 任何 参数 ， 
以 及 名 为 product list_by_category 的 模式 , 并 向 视图 提供 category_slug 参数 , 进而 根据 既 
定 目录 过 滤 商 品 。 另 外 ， 我 们 还 针对 product_detail 视图 添加 了 一 种 模式 ， 并 向 视图 传递 
id 和 slug 参数 以 检索 特定 的 商品 。 

编辑 myshop 项 目的 urls.py 文件 ， 如 下 所 示 : 


from django.contrib import admin 
from django.urls import path, include 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('', include('shop.urls', namespace='shop')), 


] 


在 对 象 的 主 URL 路 径 中 ， 将 在 名 为 shop 的 自 定义 命名 空间 下 方 包含 shop 应 用 程序 
的 URL。 

接 下 来 , 编辑 shop 应 用 程序 的 models.py 文件 ， 导 入 reverse0 函 数 ， 并 分 别 向 Category 
和 Product 模型 中 添加 get_absolute_url0 方 法 ， 如 下 所 示 : 

from django.urls import reverse 

i 

class Category (models.Model): 

es 

def get absolute url (self): 


return reverse('shop:product list by category'， 
args=[self.slug]) 


class Product (models.Model): 
a 
def get absolute url (self): 
return reverse('shop:product detail', 
args=[self.id, self.slug]) 


如 前 所 述 ，get_absolute_url(0) 可 视 为 一 种 约定 ， 进 而 针对 既定 对 象 检 索 URL。 这 目 
使 用 刚刚 定义 于 urls.py 文件 中 的 URL 路 径 。 


二 
< 
Cy 
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7.1.4 生成 目录 模板 


本 节 将 针对 水 平 列表 和 详细 视图 创建 模板 。 针 对 于 此 ， 在 shop 应 用 程序 目录 中 生成 
下 列 目录 和 文件 结构 : 


templates/ 
shop/ 
base.html 
product/ 
list.html 
detail.html 


此 处 需要 定义 基 模 板 ， 并 于 随后 在 商品 列表 和 详细 视图 中 对 其 加 以 扩展 。 编 辑 
shop/base.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{ load static %} 
<!DOCTYPE html> 
<html> 
<head> 
<meta charset="utf-8" /> 
<title>{% block title %}My shop{% endblock %}</title> 
<link href="{% static "css/base.css" %}" rel="stylesheet"> 
</head> 
<body> 
<div id="header"> 
<a href="/" class="1ogo">MY shop</a> 
</div> 
<div id="subheader"> 
<div class="cart"> 
Your cart is empty. 
</div> 
</div> 
<div id="content"> 
{ 当 block content %} 
{ 当 endblock $} 
</div> 
</body> 
</html> 


上 述 代码 定义 了 在 线 商店 所 用 的 基 模 板 。 为 了 纳入 CSS 样式 和 模板 所 用 的 图 像 ， 需 
要 复制 本 章 附带 的 静态 文件 ， 对 应 位 置 为 shop 应 用 程序 的 static/ 目 录 。 随 后 将 其 复制 至 
当前 项 目 中 的 同一 位 置 处 。 
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编辑 shop/product/list.html 模板 ， 并 向 其 添加 下 列 代码 : 


{$$ extends "shop/base.html"™" %} 
{ 当 load static %} 


{$$ block title %} 


{g% if category $}{{ category.name }}{% else %}Products{% endif %} 
{% endblock %} 


{ block content $%} 
<div id="sidebar"> 
<h3>Categories</h3> 
<ul> 
<li {% if not category %$}class="selected"{% endif %}> 
<a href="{% url "shop:product list" $%}">All</a> 


</1i> 
{% for c in categories %} 
<li {% if category.slug == c.slug %}class="selected" 


{% endif %}> 
<a href="{{ c.get absolute Url }}">{{ c.name }}</a> 
<H LIS 
{$$ endfor %$} 
</ul> 
</div> 
<div id="main" class="product-list"> 
<hl>{% if category %}{{ category.name }}{% else %}Products 
{% endif %}</hl> 
{% for product in products %} 
<div class="item"> 
<a href="{{ product.get absolute url }}"> 
<img src="{% if product.image %}{{ product.image.url }}{% 
else %}{% static "img/no image.png" %}{% endif $}"> 
</a> 
<a href="{{ product.get absolute url }}">{{ product.name }}</a> 
<br> 
${{ product.price }} 
</div> 
{S$ endfor %$} 
</div> 
{$$ endblock $} 


上 述 代 码 设 置 了 商品 列表 模板 ， 该 模板 扩展 了 shop/base.html 模板 ， 同 时 使 用 了 
categories 环境 变量 显示 侧 栏 中 的 全 部 目录 ， 并 采用 products 显示 当前 页 面 中 的 商品 。 另 
外 ， 同 一 模板 也 适用 于 以 下 两 种 情形 : 列 出 所 有 的 现 有 商品 ， 以 及 依据 某 个 目录 过 滤 的 
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商品 。 由 于 Product 模型 的 image 字段 可 为 空 ， 因 而 需要 针对 未 包含 图 像 的 商品 提供 一 幅 
默认 的 图 像 。 该 图 像 位 于 包含 img/no_image.png 相对 路 径 的 静态 文件 目录 中 。 
考虑 到 使 用 了 ImageField 存储 商品 图 像 ， 因 而 须 通 过 开发 服务 器 处 理 上 传 后 的 图 像 
交 件 。 
编辑 myshop 应 用 程序 的 settings .py 文件 ， 并 添加 下 列 设置 内 容 : 


MEDIA URL = '/media/' 
MEDIA ROOT = os.path.join (BASE DIR, 'media/') 


MEDIA_URL 表示 为 基 URL， 用 于 处 理 用 户 上 传 的 媒体 文件 。MEDIA_ROOT 则 表 
示 为 上 述 文件 所 处 的 本 地 路 径 ， 并 在 BASE_DIR 变量 前 动态 地 对 其 加 以 构建 。 

Django 可 以 使 用 开发 服务 器 提供 上 传 的 媒体 文件 。 对 此 ， 编 辑 myshop 应 用 程序 的 
urls.py 文件 ， 并 向 其 添加 下 列 代码 : 

from django.conf import settings 

from django.conf .urls.static import static 


urlpatterns = [ 
Se 
] 
if settings .DEBUG: 
urlpatterns += static(settings .MEDIA URL, 
document root=settings .MEDIA ROOT) 


请 记 住 ， 我 们 只 在 开发 期 间 以 这 种 方式 处 理 静 态 文件 。 在 生产 环境 中 ， 永 远 不 要 通 
过 Django 提供 静态 文件 。 

下 面向 在 线 商 店 中 添加 一 些 商 品 ， 并 在 浏览 器 中 打开 http://127.0.0.1:8000/。 图 7.2 显 
示 了 相应 的 商品 列表 页 面 。 


Your cart is empty. 


Fos 


Products 


Categories 


一 


Tea powder 
$21.2 
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如 果 利 


no_image.png 图 像 ， 如 图 7.3 所 示 。 


NO IMAGE 
AVAILABLE 


Green tea 


$30 


管理 站 点 生成 了 一 件 商品 ， 且 未 对 


Tea powder 


图 7.3 


$21.2 


229 


上 传 任意 图 像 ， 那 么 将 显示 默认 的 


接 下 来 编辑 商品 详细 模板 。 编 辑 shop/product/detail.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{% extends "shop/base.html" %} 
{$$ load static %} 


{% block title %} 
{{ product.name }} 
{$$ endblock %} 


{ 当 block content %} 
<div class="product-detail"> 
<img src="{% if product.image %}{{ product.image.url }}{% else %} 
{g% static "img/no image.png" %}{% endif $%}"> 
<hl>{{ product.name }}</hl> 
<h2><a href="{{ product.category.get absolute url }}">{{ 
product .category }}</a></h2> 
<p class="price">${{ product.price }}</p> 
{{ product.description|llinebreaks }} 
</div> 
{ 当 endblock %} 


调用 关联 目录 对 象 上 的 get_absolute_ url() 方 法 ， 以 显示 属于 同一 目录 下 的 商品 。 在 浏 


览 器 中 打 


http://127.0.0.1:8000/, 单 击 人 各 


E 意 一 件 商品 以 查看 产品 详细 页 


至 此 ， 我 们 创建 了 基本 的 商品 目录 。 


1 ,如 


图 


7.4 所 示 。 
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Your cart is empty 


Red tea 


Tea 


$45.5 


Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod 
tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, 
quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo 
consequat Duis aute irure dolor in reprehenderit in voluptate velit esse cillum 
dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, 
sunt in culpa qui officia deserunt mollit anim id est laborum. 


图 7.4 
7.2 创建 购物 车 


在 构建 了 商品 目录 后 ， 下 一 步 是 创建 购物 车 ， 用 户 可 以 此 选取 希望 购买 的 商品 。 购 
物 车 可 使 用 户 选择 商品 并 设置 购物 数量 。 随 后 ， 可 临时 存储 此 类 信息 ， 与 此 同时 ， 用 户 
可 继续 浏览 网 站 直至 最 终 提 交 订 单 。 购 物 车 须 在 会 话 中 实现 持久 化 操作 ， 以 使 购物 车 中 
的 各 项 内 容 在 用 户 访 问 期 间 得 以 维护 。 

本 节 将 采用 Django 的 会 话 框 架 对 购物 车 实现 持久 化 操作 。 购 物 车 将 存在 于 当前 会 话 
中 ， 直 至 购物 结束 或 者 付款 完毕 。 除 此 之 外 ， 还 需 针 对 购物 车 及 其 各 项 内 容 创建 额外 的 
Django 模型 。 


7.2.1 使 用 Django 会 话 


Django 提供 了 会 话 框架 ， 并 支持 匿名 和 用 户 会 话 。 会 话 框架 可 针对 每 名 访问 者 存储 
任意 数据 。 会 话 数据 存储 于 服务 器 端 ， 除 非 使 用 基于 Cookie 的 会 话 引 擎 ， 和 否则，Cookie 
包含 了 会 话 ID。 会 话 中 间 件 负责 管理 Cookie 的 发 送 和 接收 。 默 认 的 会 话 引擎 将 会 话 数据 
存储 于 数据 库 中 ， 但 用 户 也 可 选取 不 同 的 会 话 引 擎 。 
当 使 用 会 话 时 ， 须 确保 项 目的 MIDDLEWARE 设置 包含 'django.contrib.sessions. 
Imiddleware.SessionMiddleware'， 该 中 间 件 将 对 会 话 进行 管理 。 当 利用 startproject 命令 创 
建新 项 目 时 ， 默 认 状 态 下 将 添加 至 MIDDLEWARE 设置 中 。 

该 会 话 中 间 件 使 得 当前 会 话 在 request 对 象 中 有 效 。 用 户 可 利用 request.session 访问 


第 7 章 ”构建 在 线 商店 “209。 


I 


前 会 话 ， 将 其 视 为 Python 字典 ， 进 而 存储 和 检索 会 话 数据 。 默 认 状态 下 ， 会 话 字 典 接 
收 可 序列 化 为 JSON 的 任意 Python 对 象 。 用 户 可 按照 下 列 方式 设置 会 话 中 的 变量 : 
Frequest.session['foo'] = 'bar' 

下 列 代码 显示 了 会 话 密 钥 的 检索 方式 : 

request .session.get('foo') 


下 列 代码 显示 了 删除 之 前 存储 于 会 话 中 的 密 钥 : 


del request.session['foo'] 
这 里 ， 可 将 request.session 视 作 标准 的 Python 字典 。 


@ 注意， 

当 用 户 登 录 站 点 时 ， 其 匿名 会 话 将 消失 ， 同 时 为 验证 后 的 用 户 创建 新 的 会 话 。 如 果 
用 户 将 数据 项 存储 于 匿名 会 话 中 , 且 在 登录 后 继续 持 有 , 则 需要 将 原 会 话 数据 复制 至 新 
的 会 话 中 


7.2.2 会话 设置 


相应 地 ， 存 在 多 种 设置 方案 可 对 项 目 会 话 进行 配置 ， 其 中 较为 重要 的 是 SESSION_ 
ENGINE。 该 设置 可 用 于 确定 会 话 的 存储 位 置 。 默 认 状 态 下 ，Django 利用 django.contrib. 
sessions 应 用 程序 的 Session 模型 将 会 话 存储 于 数据 库 中 。 
Django 提供 了 以 下 会 话 数据 存储 选项 。 
口 ”数据 库 会 话 : 会 话 数据 存储 于 数据 库 中 ， 这 也 是 默认 的 会 话 引擎 。 
口 基于 文件 的 会 话 : 会 话 数据 存储 于 文件 系统 中 。 
口 ”缓存 会 话 : 会 话 数据 存储 于 缓存 后 端 中 。 通 过 CACHES 设置 ， 可 指定 相应 的 组 
存 后 端 。 缓 存 系统 中 的 会 话 存 储 提供 了 较 好 的 性 能 。 
口 ”缓存 数据 库 会 话 : 会 话 数 据 存 储 于 直接 写 入 的 缓存 和 数据 库 中 。 仅 当 数 据 未 处 
于 缓存 中 时 方 使 用 数据 库 。 
口 基于 Cookie 的 会 话 : 会 话 数据 存储 于 发 送 至 浏览 器 的 Cookie 中 。 


© 注意 ， 
基于 缓存 的 会 话 引 擎 其 性 能 将 更 加 优异 。 Django 支持 Memcached， 读 者 也 可 针对 
Redis 获取 第 三 方 缓存 后 端 程序 以 及 其 他 缓存 系统 。 


我 们 也 可 利用 特定 的 设置 自 定义 会 话 。 下 列 内 容 列 出 了 某 些 较为 重要 的 与 会 话 相 关 
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口 “SESSION_ COOKIE AGE: 表示 会 话 Cookie 的 持续 时 间 (以 秒 计 〉 ， 默 认 值 为 
1209600 秒 〈 即 两 个 星期 ) 。 
口 SESSION COOKIE DOMAIN: 表示 会 话 Cookie 所 用 的 域名 。 将 其 设置 为 
mydomain.com 可 启用 跨 域 Cookie; 或 者 针对 标准 的 域 Cookie 使 用 None。 
口 “SESSION COOKIE SECURE: 表示 为 一 个 布尔 值 , 表明 仅 当当 前 连接 为 HTTPS 
连接 时 ，Cookie 方 被 发 送 。 
口 SESSION EXPIRE AT BROWSER CLOSE: 表示 为 一 个 布尔 值 ， 表 明 关闭 济 
览 器 时 对 其 会 话 将 过 期 。 
口 ”SESSION_SAVE_ EVERY _ REQUEST: 表示 为 一 个 布尔 值 。 若 该 值 为 True， 将 
把 每 个 请 求 会 话 存储 至 数据 库 中 。 每 次 保存 时 ， 会 话 过 期 也 将 被 更 新 。 
读者 可 访问 https://docs.djangoproject.com/en/2.0/ref/settings/#sessions， 以 了 解 全 部 会 
话 设 置 和 默认 值 。 


7.2.3 会话 过 期 


我 们 可 选择 使 用 浏览 器 长 度 (browser-length) 会 话 ， 或 者 使 用 SESSION_EXPIRE_ 
AT_BROWSER_CLOSE 设置 的 持久 会 话 。 默 认 时 ， 该 设置 项 设置 为 False， 并 强制 会 话 
持续 时 间 为 存储 于 SESSION_COOKIE AGE 设置 中 po 如 果 SESSION_EXPIRE_ 
AT BROWSER_CLOSE 设置 为 Tme， 当 用 户 关 闭 浏览 器 时 会 话 将 过 期 ，SESSION_ 
COOKIE AGE 设置 将 不 再 起 到 任何 作用 。 

我 们 还 可 通过 request.session 中 的 set_expiry0 方 法 履 写 当前 会 话 的 持续 时 间 。 


7.2.4 将 购物 车 存储 于 会 话 中 


在 将 购物 车 数据 存储 至 某 个 会 话 中 时 ， 需 要 创建 一 个 简单 的 结构 并 序列 化 为 JSON。 
， 购 物 车 需要 针对 其 中 的 各 项 内 容 设置 以 下 数据 : 
口 ”Product 实例 ID。 
口 ”商品 的 选 购 数 量 。 
口 ”商品 的 单价 。 

考虑 到 商品 价格 可 能 会 出 现 变 化 ， 因 而 在 添加 至 购物 车 后 ， 可 将 商品 价格 以 及 商品 
身 一 同 存储 。 据 此 ， 当 用 户 将 商品 添加 至 购物 车 后 ， 可 使 用 当前 的 商品 价格 ， 且 无 须 
考虑 该 商品 价格 后 期 是 否 会 发 生变 化 。 


这 里 


还 
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下 面 将 添加 相关 功能 ， 创 建 购物 车 并 将 其 与 会 话 进行 关联 。 购 物 车 的 工作 方式 如 下 

所 示 : 

口 ” 当 使 用 购物 车 时 ， 须 检测 自 定义 会 话 密 钥 是 否 被 设置 。 若 会 话 中 未 设置 购物 车 ， 
将 创建 新 的 购物 车 并 将 其 保存 至 购物 车 会 话 密 钥 中 。 

口 “ 对 于 连续 请 求 ， 可 执行 相同 的 检测 过 程 ， 并 从 购物 车 会 话 密 钥 中 获取 其 中 的 数 

据 项 。 我 们 可 根据 当前 会 话 检 索 购 物 车 数据 项 ， 并 从 数据 库 中 检索 其 关联 的 


Product 对 象 。 
编辑 当前 项 目 中 的 settings.py 文件 ， 并 向 其 中 添加 下 列 代码 : 
CART SESSION ID = 'cart' 


我 们 将 以 此 将 购物 车 存储 至 用 户 对 话 中 。 由 于 Django 会 话 是 按 访 问 者 管理 的 ， 所 以 
可 以 对 所 有 会 话 使 用 相同 的 购物 车 会 话 密 钥 。 

接 下 来 创建 一 个 应 用 程序 用 于 管理 购物 车 。 打 开 终 端 并 创建 新 的 应 用 程序 ， 在 当前 
项 目 目录 中 运行 下 列 命令 : 


python manage.py startapp cart 


随后 ， 编 辑 当前 项 目的 settings.py 文件 ， 将 新 的 应 用 程序 添加 至 INSTALLED_APPS 
设置 中 ， 如 下 所 示 : 
INSTALLED APPS = [ 
坟 | 
'shop.apps.ShopConfig', 
'Cart.apps.CartConfig', 
] 


在 cart 应 用 程序 目录 中 创建 新 文件 ， 将 其 命名 为 cartpy， 并 向 其 中 添加 下 列 代码 : 


from decimal import Decimal 
from django.conf import settings 
from shop.models import Product 


class Cart (object): 


def init (self, request): 


mmm 


Initialize the cart. 
mm 
self.session = request.session 
cart = self.session.get (settings.cART SESSION ID) 
LE not cart: 
# save an empty cart in the session 
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cart = self.session[settings.CART SESSION ID] 
Self.cart = cart 


= 


上 述 Cart 类 负责 管理 购物 车 ， 同 时 ， 该 购物 车 需要 通过 request 对 象 进行 初始 化 。 此 


处 利用 selfsession = request.session 存储 当前 会 话 ， 使 其 可 访问 Cart 类 中 的 其 他 方法 。 首 


先 ， 
话 


可 利用 self.session.get(settings.CART_SESSION_ID) 从 当前 会 话 中 获取 购物 车 。 若 会 
未 发 现 购物 车 ， 通 过 在 会 话 中 设置 一 个 空 字典 ， 可 创建 一 个 空 的 购物 车 。 这 里 期 望 


购物 车 字典 使 用 商品 D 作为 键 ， 以 及 一 个 包含 数量 和 价格 的 字典 作为 每 个 键 值 。 据 此 ， 


可 古 


add! 


转换 为 字符 串 ， 以 便 对 其 执行 序列 化 操作 。 最 后 ， 调 用 save0 保 存 会 话 中 的 购物 车 。 


外 保 某 件 商 品 不 会 被 多 次 添加 至 购物 车 中 ,该 方法 还 可 简化 购物 车 数据 项 的 检索 方式 。 


下 面 定义 一 个 方法 ， 并 将 商品 添加 至 购物 车 中 ， 或 者 更 新 其 中 的 商品 数量 。 下 面 将 


(0 和 save() 方 法 添加 至 Cart 类 中 。 


class Cart (object) : 


# 


mm 


Add a product to the cart or update its quantity. 

mm 

Product id = str (Product.id) 

if product id not in self.cart: 
self.cart[product id] = {'quantity': 0, 


def addl(self, product, quantity=1, update quantity=False): 


'Price': str(product.price)} 


if update quantity: 
self.cart[product id]['quantity'] = quantity 
else: 


self.cart[product id]['quantity'] += quantity 


self.save() 


def savel(self): 


# mark the session as "modified" to make sure it gets saved 


self.session.modified = True 
其 中 ，add0) 方 法 接收 下 列 参数 作为 输入 内 容 。 
口 ”product: 表示 购物 车 中 添加 或 更 新 的 product 实例 。 
口 quantity: 表示 商品 数量 ， 作 为 可 选 的 整数 值 ， 其 默认 值 为 1。 


口 update quantity: 定义 为 一 个 布尔 值 ， 表 示 当 前 数量 是 否 需要 利 


上 给 定 的 量 值 进 


行 更 新 “True》， 或 者 新 量 值 是 否 需 要 加 入 现 有 的 量 值 中 (False》。 


我 们 使 用 商品 DD 作为 购物 车 内 容 字典 中 的 键 ,由 于 Django 使 用 JSON 序列 化 会 话 数 据 ， 
且 JSON 仅 支 持 字符 串 ， 因 而 需要 将 商品 ID 转换 为 字符 串 。 商 品 ID 表示 为 一 个 键 ， 所 持久 
化 的 对 应 值 则 定义 为 一 个 字典 ， 其 中 包含 了 商品 的 数量 和 价格 。 这里， 商品 的 价格 将 从 小 数 
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save() 方 法 通过 session modified = True 将 会 话 标记 为 “已 调整 ”， 这 将 通知 Django， 
该 会 话 已 发 生变 化 且 需 要 保存 。 

除 此 之 外 ， 还 需要 定义 一 个 方法 ， 并 从 购物 车 中 移 除 商品 。 对 此 ， 将 下 列 代码 添加 
至 Cart 类 中 : 

class Cart (object) : 


兴 
def removel(self, product): 


mam 


Remove a product from the cart. 


mm 

Product id = str (Product.id) 

if product id in self.cart: 
del self.cart[product id] 
self.save() 


remove() 方 法 从 购物 车 字典 中 移 除 了 既定 商品 ,并 调用 save0 方 法 更 新 会 话 中 的 购物 车 。 
下 面 将 遍历 购物 车 中 的 各 项 内 容 ， 并 访问 所 关联 的 Product 实例 。 对 此 ， 可 在 类 中 定 
义 一 个 _iter_0 方 法 ， 并 将 其 添加 至 Cart 类 中 : 


class Cart (object): 
a 
def _ iter (self): 


mn 


Iterate over the items in the cart and get the products 
from the database. 

mn 

Product ids = self.cart.keys() 

# get the product objects and add them to the cart 
Products = Product.objects.filter(id in=product ids) 


cart = self.cart.copy() 
for product in products: 
cart[str(product.id)]['product'] = product 


for item in cart.values(): 
item['price'] = Decimal (item['price']) 
item['total price'] = item['price'] * item['quantity'] 
yield item 


在 _iter_0 方 法 中 ， 将 检索 购物 车 中 的 Product 实例 ， 并 将 其 包含 至 购物 车 条 目 


最 后 ,还 需要 遍历 购物 车 中 的 各 个 条 目 , 将 其 价格 转换 为 小 数 ， 并 将 total price 届 性 添加 
至 各 个 条 目 中 。 


- 


.214 。 


除 此 之 外 ， 还 需要 一 种 方法 返 


Django 项 


Python 将 调 


储 于 购物 车 中 的 全 部 条 目的 数量 。 下 
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回 购物 车 中 总 数量 。 当 执行 对 象 上 的 len0 方 法 时 ， 


len_0 方 法 检索 其 长 度 。 此 处 将 自 定义 一 个 _len _0 方 法， 并 返回 存 


class Cart (object) : 


# 


mmnm 


def _ len (self): 


将 _len 0 方法 添加 至 Cart 类 中 。 


Count all items in the cart. 


mm 


return sum(item['quantity'] for item in self.cart.values()) 
该 方法 返回 购物 车 中 全 部 条 目的 总 数 。 
同时 ， 添 加 下 列 方法 ， 并 计算 购物 车 中 全 部 条 目的 价格 。 


class Cart (object) : 


下 


def get total pricel(self): 
return sum(Decimal (item['price']) * item['quantity'] for item in 
self.cart.values ()) 


最 后 ， 添 加 下 列 方法 并 清空 购物 车 会 话 : 


class Cart (object): 


Se 


def clearl(self): 
# remove cart from session 
del self.session[settings.CART SESSION ID] 


self 


.save() 


至 此 ， 可 使 用 Cart 类 对 购物 车 进行 管理 。 
7.2.5 创建 购物 车 视图 


前 述 内 容 定义 了 Cart 类 并 可 对 购物 车 加 以 管理 。 相 应 地 ， 还 需 创建 相关 视图 ， 进 而 
从 中 添加 或 移 除 相关 条 目 ， 如 下 所 示 : 
口 ”添加 或 更 新 购物 车 条 目的 视图 


口 ” 从 购物 车 


口 ”显示 购物 车 条 目 和 总 量 的 视图 。 


1. 向 购物 车 中 


P 移 除 条 目的 视图 。 


添加 条 目 


为 了 向 购物 车 


， 并 可 处 理 商 品 的 总 量 。 


Ph 加 入 相关 条 目 , 我 们 需要 一 个 表单 以 使 用 户 可 选择 相应 的 商品 数量 。 
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对 此 ， 在 cart 应 用 程序 目录 中 创建 forms.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django import forms 
PRODUCT QUANTITY CHOICES = [(i, str(i)) for i in range(1，21) 


class CartAddProductForm(forms.Form): 
quantity = forms.TypedChoiceField( 
choices=PRODUCT QUANTITY CHOICES, 
coerce=int) 
update = forms.BooleanField (required=False, 
initial=False, 
widget=forms .HiddenInput) 


我 们 将 使 用 该 表单 向 购物 车 中 加 入 商品 -CartAddProductForm 类 中 定义 了 以 下 两 个 字段 。 

口 。，quantity: 用 户 在 1~20 选取 某 个 量 值 ， 随 后 采用 TypedChoiceField (coerce=int) 
将 输入 转换 为 一 个 整数 。 

口 update: 表示 当前 量 值 是 否 加 至 该 商品 购物 车 的 现 有 数量 上 (False〉; 或 者 现 有 
数量 通过 该 数值 予以 更 新 〈True) 。 由 于 并 不 希望 向 用 户 显 示 ， 因 而 针对 该 字 
段 使 用 了 一 个 HiddenInput 微 件 。 

接 下 来 创建 一 个 视图 ， 并 向 购物 车 中 添加 内 容 。 编 辑 cart 应 用 程序 的 views.py 文件 ， 

并 向 其 中 添加 下 列 代 码 : 


from django.shortcuts import render, redirect, get object or 404 
from django.views.decorators.http import require POST 

from shop.models import Product 

from .cart import Cart 

from .forms import CartAddProductForm 


@require POST 
def cart add(request, product id) : 
cart = Cart (request) 
product = get object or 404(Product, id=product id) 
form = CartAddProductForm (request .POST) 
i Formm.is valid(t): 
cd = form.cleaned data 
cart.add (product=product, 
quantity=cd['quantity'], 
update quantity=cd['update']) 
return redirect('cart:cart detail') 


该 视图 负责 将 商品 添加 至 购物 车 中 ， 或 者 更 新 现 有 商品 的 数量 。 由 于 该 视图 将 修改 
数据 ， 因 而 使 用 了 require POST 装饰 器 且 仅 支持 POST 请 求 。 另 外 ， 该 视图 接收 商品 人 D 
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作为 参数 。 相 应 地 ， 利 用 给 定 的 ID 检索 Product， 同 时 验证 CartAddProductForm。 若 该 
表单 有 效 ， 将 添加 或 更 新 购物 车 中 的 商品 。 最 后 ， 该 视图 将 重 定向 至 cart_detail URL， 以 
显示 购物 车 中 的 内 容 。 稍 后 将 创建 一 个 cart_detail 视图 。 

除 此 之 外 ,还 需要 一 个 视图 移 除 购物 车 中 的 条 目 。 对 此 ,向 cart 应 用 程序 的 views.py 
文件 中 添加 下 列 代码 : 


def cart remove (request, product id) : 
cart = Cart (request) 
product = get object or 404(Product, id=product id) 
cart.remove (product) 
return redirect('cart:cart detail') 
cart_remove 视图 接收 商品 ID 作为 参数 。 我 们 可 利用 给 定 的 ID 检索 Product 实例 ， 
并 从 购物 车 中 移 除 该 商品 。 随 后 ， 可 将 用 户 重 定向 至 cart_detail URL。 
最 后 ， 还 需要 一 个 视图 显示 购物 车 及 其 条 目 。 相 应 地 ， 可 向 cart 应 用 程序 的 views.py 
文件 添加 下 列 视图 : 
def cart detail (request): 
cart = Cart (request) 
return render(request, 'cart/detail.html', {'cart': cart}) 
cart_detail 视图 将 获取 当前 购物 车 并 对 其 加 以 显示 。 
之 前 曾 创建 了 视图 并 将 商品 添加 至 购物 车 中 、 更 新 商品 数量 、 从 购物 车 中 移 除 条 目 
并 显示 购物 车 内 容 。 下 面 针对 此 类 视图 添加 URL 路 径 。 在 cart 应 用 程序 目录 中 创建 新 文 
件 ， 将 其 命名 为 urlspy 并 添加 下 列 URL。 
from django.urls import path 
from . import views 


app_name = "Cart'" 


urlpatterns = [ 
path('', views.cart detail, name='cart detail'), 
path('add/<int:product id>/', 
Views.cart add, 
name='cart add'), 
path('remove/<int:product id>/', 
Views .cart remove, 
name='cart remove'), 


] 
编辑 myshop 项 目的 urls.py 主 文件 ， 添 加 下 列 URL 路 径 以 包含 购物 车 URL: 


Uripatterns =: |[ 
path('admin/', admin.site.urls), 
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path('cart/', include('cart.urls', namespace='cart')), 
path('', include('shop.urls', namespace="'shop')), 


] 

确保 在 shop.urls 路 径 之 前 添加 URL 路 径 ， 因 为 后 者 更 具 局 限 性 。 

2. 构建 模板 显示 购物 车 

cart add 和 cart remove 视图 并 不 显示 任何 模板 ， 因 而 需要 针对 cart_detail 视图 创建 
一 个 模板 ， 以 显示 购物 车 条 目 以 及 商品 总 量 。 

在 cart 目录 中 生成 下 列 文件 结构 : 


templates/ 
cart/ 
detail.html 


编辑 cart/detail.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{% extends "shop/base.html" %} 
{% load static %} 


{% block title %} 
Your shopping cart 
{S$ endblock %$} 


{ block content %} 
<hl>Your shopping cart</hl> 
<table class="cart"> 
<thead> 
<tr> 
<th>Image</th> 
<th>Product</th> 
<th>Quantity</th> 
<th>Remove</th> 
<th>Unit price</th> 
<th>Price</th> 
HErS 
</thead> 
<tbody> 
{% for item in cart $%} 
{% with product=item.product %} 
<tr> 
<td> 
<a href="{{ product.get absolute url }}"> 
<img src="{% if product.image %}{{ product.image.url }} 
{$$ else %}{% static "img/no image.png" %}{% endif %}"> 
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</a> 
</td> 
<td>{{ Product .name }}</td> 
<td>{{ item.quantity }}</td> 
<td><a href="{% url "cart:cart remove" product.id 
$$}">Remove</a></td> 
<td class="num">${{ item.price }}</td> 
<td class="num">${{ item.total price }}</td> 
</tr> 
{S$ endwith %} 
{SS endfor 要 } 
<tr class="total"> 
<td>Total</td> 
<td colspan="4"></td> 
<td class="num">${{ cart.get total price }}</td> 
</tr> 
</tbody> 
</table> 
<p class="text-right"> 
<a href="{% url "shop:product list" $%}" class="button 
light">Continue shopping</a> 
<a href="#" class="button">Checkout</a> 
</p> 
{%S endblock %} 


上 述 模 板 用 于 显示 购物 车 中 的 内 容 并 包含 了 一 个 表 (存储 在 当前 购物 车 中 的 条 目 〉。 
利用 发 送 至 cart_add 视图 的 表单 ， 用 户 可 修改 所 选 商品 的 数量 。 此 外 ， 通 过 每 个 条 目的 
Remove 链接 ， 用 户 还 可 移 除 购物 车 中 的 条 目 。 

3. 向 购物 车 中 添加 商品 

这 里 需要 在 商品 详细 页 面 中 设置 一 个 Add to cart 按钮 。 对 此 ， 可 编辑 shop 应 用 程序 
的 views.py 文件 ， 并 将 CartAddProductForm 添加 至 product_detail 视图 中 ， 如 下 所 示 : 


from cart.forms import CartAddProductForm 


def product detail (request, id, slug): 
product = get object or 404(Product, id=id, 
slug=slug, 
available=True) 
cart product form = CartAddProductForm() 
return render(request, 
'shop/product/detail.html', 
{product: product, 
'Cart product form': cart product form}) 
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编辑 shop 应 用 程序 的 shop/product/detail.html 模板 , 并 将 下 列表 单 添加 至 商品 的 价格 中 : 


<p class="price">${{ product.price }}</p> 

<form action="{% url "Cart:cart add" Product.id %}" method="post"> 
{{ cart product form }} 
{% csrf token %} 
<input type="submit" value="Add to cart"> 

</form> 

{{ product.description|linebreaks }} 


运行 python managepy runserver 命令 并 启动 开发 服务 器 。 在 浏览 器 中 打开 http://127.0.0.1: 
8000/， 并 访问 商品 的 详细 页 面 。 其 中 包含 了 一 个 表单 ， 可 在 向 购物 车 添加 商品 之 前 选取 
对 应 的 数量 ， 如 图 7.5 所 示 。 


Your cart is empty. 


Red tea 


Tea 


$45.5 


图 7.5 


选择 具体 数量 并 单 击 Add to cart 按钮 。 该 表单 通过 POST 提交 至 cart_add 视图 ， 并 

会 话 中 将 商品 加 入 购物 车 中 ， 包 括 其 短期 价格 以 及 所 选 的 数量 。 随 后 ， 该 视图 将 用 户 
重 定向 至 购物 车 详细 页 面 ， 如 图 7.6 所 示 。 
4. 更 新 购物 车 中 的 商品 数量 
当 用 户 查 看 购物 车 时 ， 可 能 需要 在 提交 订单 之 前 修改 商品 数量 。 相 应 地 ， 用 户 应 可 
在 购物 车 详细 页 面 中 更 改 商 品 数量 。 

编辑 cart 应 用 程序 的 views.py 文件 ， 并 修改 cart_detail 视图 ， 如 下 所 示 : 


def cart detail (request): 
cart = Cart (request) 
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for item in cart: 
item['update quantity form'] = CartAddProductForm( 
initial={'quantity': item['quantity'], 
'update': True}) 
return render(request, 'cart/detail.html', {'cart': cart}) 


Your shopping cart 


Image Product Quantity Remove Unit price Price 
Remove 


$91.0 


Continue shopping Checkout 


图 7.6 


此 处 针对 购物 车 中 的 各 条 目 创建 了 CartAddProductForm 实例 ， 并 支持 商品 数量 的 修 


改 操作 。 随 后 利用 当前 数量 初始 化 表单 ， 并 将 update 字段 设置 为 True 
至 cart_add 视图 中 时 ， 当 前 数量 被 新 值 所 替换 。 
下 面 编辑 cart 应 用 程序 的 cart/detail.html 模板 ， 并 考察 下 列 代码 行 : 
<td>{{ item.quantity }}</td> 
并 利用 下 列 代码 进行 蔡 换 : 


<td> 


<form action="{% url "cart:cart add" product.id %}" method="post"> 


{{ item.update quantity form.quantity }} 
{{ item.update quantity form.update }} 
<input type="submit" value="Update"> 
{% csrf token %} 
</form> 
</td> 


在 浏览 器 中 打开 http://127.0.0.1:8000/cart/, 将 显示 一 个 表单 ， 进而 可 针对 各 条 目 编辑 
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商品 数量 ， 如 图 7.7 所 示 。 


Your shopping cart 


Image Product ”Quantity Remove Unit price Price 


Redtea 2 眉 Remove 


$91.0 


Continue shopping 


图 7.7 


修改 商品 数量 并 单 击 Update 按钮 以 测试 新 的 功能 项 。 此 外 ， 单 击 Remove 链接 还 可 
移 除 购物 车 中 的 商品 条 目 。 


7.2.6 ”针对 购物 车 创建 上 下 文 处 理 器 


读者 可 能 已 经 注意 到 ， 即 使 购物 车 中 包含 商品 ， 站 点 页 面 上 方 也 会 显示 “Your cart is 
empty” 这 一 消息 。 相 反 ， 此 处 应 显示 购物 车 中 商品 的 全 部 数量 和 价格 。 由 于 该 消息 将 显 
示 于 全 部 页 面 中 ， 我 们 需要 设置 一 个 上 下 文 处 理 器 ， 并 将 当前 购物 车 包含 于 请 求 上 下 文 
中 ， 而 与 处 理 请 求 的 视图 无 关 。 

1. 上 下 文 处 理 器 

上 下 文 处 理 器 表示 为 一 个 Python 函数 ， 并 接收 request 对 象 作为 参数 , 同时 返回 一 个 
字典 并 添加 至 请 求 上 下 文中 。 当 以 全 局 方式 对 所 有 模板 执行 相关 操作 时 ， 上 下 文 处 理 器 
十 分 有 用 。 

默认 条 件 下 ， 当 利用 startproject 命令 创建 新 项 目 时 ， 项 目 将 在 TEMPLATES 设置 的 
context processors 选项 中 包含 下 列 模板 上 下 文 处 理 器 。 

口 django.template.context_processors.debug: 这 将 设置 上 下 文中 的 布尔 值 debug 和 

sql_queries 变量 ， 该 上 下 文 表示 为 请 求 中 执行 的 SQL 查询 列表 。 
口 django.template.context_processors.request: 这 将 设置 上 下 文中 的 request 变量 。 
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口 ”django.contrib_auth.context processors.auth: 这 将 设置 请 求 中 的 user 变量 。 
口 ”django.contrib messages.context processors messages: 这 将 设置 上 下 文中 的 
messages 变量 ， 该 上 下 文中 包含 了 利用 消息 框架 生成 的 全 部 消息 。 

Django 还 可 使 用 django.template.context processors.csrf 以 避免 跨 站 点 伪造 攻击 ,该 上 
下 文 处 理 器 并 未 出 现 于 当前 设置 中 ， 出 于 安全 原因 ， 一般 会 处 于 开启 状态 且 无 法 被 关闭 。 

读者 可 访问 https://docs.djangoproject.com/en/2.0/ref/templates/api/#built-in-template- 
context-processors， 以 查看 全 部 内 置 上 下 文 处 理 器 列表 。 

2. 将 购物 车 设置 至 请 求 上 下 文中 

下 面 创建 上 下 文 处 理 器 ， 并 将 当前 购物 车 设置 到 请 求 上 下 文中 ， 从 而 可 在 任意 模板 
中 访问 购物 车 。 

在 cart 应 用 程序 目录 中 创建 新 文件 ， 将 其 命名 为 context_processors.py。 上 下 文 处 理 
器 可 位 于 代码 的 任意 位 置 ， 下 面向 当前 文件 中 添加 下 列 代码 : 


from .cart import Cart 


def cart (request): 
turn {'cart': Cart (request)} 


上 下 文 处 理 器 表示 为 一 个 函数 ， 接 收 request 对 象 作 为 参数 ， 并 返回 一 个 对 象 字 典 ， 
且 适 用 于 利用 RequestContext 显示 的 所 有 模板 。 在 当前 上 下 文 处 理 器 中 ， 将 通过 request 
对 象 实例 化 购物 车 ， 并 针对 模板 定义 一 个 名 为 cart 的 变量 。 

编辑 项 目 中 的 settings.py 文件 ， 并 将 cart.context_processors.cart 添加 至 TEMPLATES 
设置 中 的 context_ processors 选项 中 ， 如 下 所 示 : 


TEMPLATES = [ 
{ 
'BACKEND': 'django.template.backends.django.DjangoTemplates', 
ER 
"APP' DIRS*: Triey 
“OPTIONSE2 区 
"Context processors': [ 
ne 
'Cart.context processors.cart', 
]， 
]， 
}, 
] 


每 次 利用 Django 的 RequestContext 显示 模板 时 ， 将 执行 cart 上 下 文 处 理 器 。cart 变 
量 将 在 模板 的 上 下 文中 被 设置 。 
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人 @@ 注意 : 

上 下 文 模板 在 使 用 了 RequestContext 的 所 有 模板 中 被 执行 。 如果 当前 功能 在 所 有 模 
板 中 并 非 必 需 , 特别 是 涉及 数据 库 查询 时 ,那么 ,读者 可 能 希望 创建 一 个 自 定义 模板 标 
签 ， 而 非 上 下 文 处 理 器 。 


编辑 shop 应 用 程序 的 shop/base.html 模板 ， 并 查看 下 列 代码 行 : 


<div class="cart"> 
Your cart is empty. 
</div> 
并 利用 下 列 代码 行进 行 蔡 换 : 
<div class="cart"> 
{% with total items=cart|length %} 
{% if cartllength > 0 %} 
Your cart: 
<a href="{% url "cart:cart detail" %}"> 
{{ total items }} item{{ total items|pluralize }}, 
${{ cart.get total price }} 
</a> 
{% else %} 
Your cart is empty. 
{% endif %} 
{% endwith %} 
</div> 


利用 python manage.py runserver 命令 重 载 服务 器 ， 在 浏览 器 中 打开 http:/127.0.0.1:8000/， 
并 向 购物 车 中 添加 某 些 商 品 。 在 站 点 上 方位 置 处 ， 我 们 可 以 看 到 购物 车 中 的 商品 数量 以 
及 全 部 价格 ， 如 图 7.8 所 示 。 


Your cart: 2 items, $91.0 


图 7.8 


7.3 注册 客户 订单 


当 对 购物 车 检查 完毕 后 ， 需 要 向 数据 库 中 保存 一 个 订单 。 订 单 包 含 了 客户 信息 及 划 
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所 购买 的 商品 。 

针对 客户 订单 管理 ， 利 用 下 列 命令 创建 新 的 应 用 程序 : 

Python manage.py startapp orders 

编辑 项 目 中 的 settings.py 文件 ， 并 向 INSTALLED_APPS 设置 中 添加 新 的 应 用 程序 ， 
如 下 所 示 : 


INSTALLED APPS = [ 
1 
"orders .apps.OrdersConfig' ， 


] 
随后 将 激活 orders 应 用 程序 。 


7.3.1 创建 订单 模型 


对 此 ， 需 要 一 个 模型 存储 订单 详细 信息 ， 而 另 一 个 模型 用 于 存储 所 购买 的 商品 ， 包 
括 价格 和 数量 。 对 此 , 编辑 orders 应 用 程序 中 的 models.py 文件 , 并 向 其 中 添加 下 列 代码 ; 


from django.db import models 
from shop.models import Product 


class Order (models.Model): 
first name = models.CharField (max length=50) 
last name = models.CharField (max length=50) 
email = models.EmailField() 
address = models.CharField (max length=250) 
postal code = models.CharField (max length=20) 
city = models.CharField (max length=100) 
created = models.DateTimeField(auto now add=True) 
updated = models.DateTimeField (auto now=True) 
paid = models.BooleanField (default=False) 


class Meta: 
ordering = ('-created',) 


def str (self): 
return 'Order {}'.format (self.id) 


def get total cost(self): 
return suml(item.get cost() for item in self.items.all()) 


class OrderItem(models.Model) : 
order = models.ForeignKey (Order, 
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related name='items' 


on delete=models .CASCADE) 
product = models.ForeignKey (Product, 
related name='order items', 
on delete=models .CASCADE) 
price = models.DecimalField (max digits=10, decimal places=2) 
quantity = models.PositiveIntegerField (default=1) 


def ste "(SolLE): 
return '{}'.format (self.id) 


def get cost(self): 
return self.price * self.quantity 


Order 模型 包含 了 多 个 字段 ， 用 于 存储 客户 信息 。 其 中 ，paid 字段 默认 设置 为 False。 
稍 后 ， 将 使 用 该 字段 区 分 付款 以 及 未 付款 订单 。 此 外 ， 还 需要 定义 一 个 get_total_cost() 
方法 ， 以 获取 订单 中 全 部 购买 商品 的 价格 。 

OrderItem 模型 可 存储 商品 、 数 量 以 及 单 品 价格 。 相 应 地 ，get_cost0 方 法 将 返回 单 品 
价格 。 


运行 下 列 命令 ， 生 成 orders 应 用 程序 的 初始 迁移 : 
Python manage.py makemigrations 
对 应 输出 结果 如 下 所 示 : 


Migrations for 'orders': 
orders/migrations/0001 initial.py 
- Create model Order 
- Create model OrderItem 


运行 下 列 命令 ， 并 使 用 上 述 迁 移 结果 。 
Python manage.py migrate 


当前 ， 订 单 模型 与 数据 库 同步 。 
7.3.2 ”在 管理 站 点 中 包含 订单 模型 


下 面向 管理 站 点 中 添加 订单 模型 。 编 辑 orders 应 用 程序 的 admin.py 文件 ， 如 下 所 示 : 


from django .contrib import admin 
from .models import Order，OrderItem 


class OrderItemInline (admin-TabularInline) : 
model = OrderItem 
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@admin.register (Order) 
class OrderAdmin (admin.ModelAdmin): 
list display = ['id', 'first name', 'last name', 'email', 
"address', "postal code', "'city', "paid', 
"created'， "updated'] 
list filter = ['paid', 'created', "updated'] 
inlines = [OrderItemInline] 


上 述 代码 针对 OrderItem 使 用 ModelInline 类 ， 并 作为 内 联 方法 添加 至 OrderAdmin 
类 中 。 内 联 方式 可 在 所 关联 的 同一 编辑 页 面 中 包含 一 个 模型 。 


利用 python manage.py runserver 命令 运行 开发 服务 器 ， 在 浏览 器 中 打开 http://127.0.0.1: 
8000/admin/orders/order/add/， 对 应 页 面 如 图 7.9 所 示 。 


Add order 


First name: 


Last name: 


Email; 


ORDER ITEMS 


PRODUcT PRICE DELETE? 


+ Add another Order item 
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7.3.3 创建 自 定 义 订单 


当 用 户 最 终 提交 订单 时 ， 将 使 用 所 生成 的 订单 模型 对 购物 车 中 的 
作 。 新 订单 的 创建 涵盖 以 下 步骤 ; 
(1) 向 用 户 显示 订单 表单 ， 并 填充 其 相关 数据 。 


息 


品 实现 持久 化 操 


(2) 利用 输入 的 数据 创建 新 的 Order 实例 ， 并 针对 购物 车 中 的 商品 创建 所 关联 的 


OrderItem 实例 。 
(3) 清空 全 部 购物 车 中 的 内 容 ， 并 将 用 户 重 定向 至 成 功 页 面 。 
首先 ， 需 要 生成 一 个 表单 输入 订单 详细 信息 。 对 此 ， 在 orders 应 用 程序 目录 中 生 
-个 新 文件 ， 将 其 命名 为 forms.py 并 添加 下 列 代码 : 


from django import forms 
from .models import Order 


class OrderCreateForm(forms .ModelForm) : 
class Meta: 
model = Order 
fields = ['first name', 'last name', 'email', 'address', 
'postal code', 'city'] 


上 述 表单 用 于 生成 新 的 Order 对 象 。 另外 , 还 需要 一 个 视图 此 类 该 表单 并 生成 新 的 订 


单 


编辑 orders 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.shortcuts import render 
from .models import OrderItem 

from .forms import OrderCreateForm 
from cart.cart import Cart 


def order create (request): 
cart = Cart (request) 
if request.method == 'POST': 
form = OrderCreateForm(request .POST) 
if form.is valid() : 
order = form.save() 
for item in cart: 

OrderItem.objects.create (order=order, 
product=item['product'], 
price=item['price'], 
quantity=item['quantity']) 

# clear the cart 
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cart.clear() 
return render (request, 
"orders/order/created.htm1l ' ， 
{"order': order}) 
else: 
form = OrderCreateForm() 
return render (request， 
"orders/order/create -html' 
dear ul art mm 


在 order_create 视图 中 ， 将 得 到 源 自 当前 会 话 (cart = Cart(request)〉 中 的 购物 车 。 取 


决 于 对 应 的 请 求 方法 ， 具 体 将 执行 下 列 任务 : 


口 ”GET 请 求 : 实例 化 OrderCreateForm 表单 并 显示 orders/order/create.html 模板 。 

口 POST 请 求 : 验证 请 求 中 发 送 的 数据 。 如 果 数 据 有 效 ， 将 利用 order = form.save( 
在 数据 库 生 成 新 的 订单 。 随 后 将 遍历 购物 车 中 的 商品 ， 并 针对 各 项 内 容 创 建 
OrderItem。 最 后 , 还 需要 清空 购物 车 内 容 , 并 显示 orders/order/created.html 模板 。 


在 orders 应 用 程序 中 生成 新 文件 ， 将 其 命名 为 urls.py 并 添加 下 列 代码 : 


from django.urls import path 
from . import views 


app name = 'orders' 


urlpatterns = [ 


path('create/', views.order create, name='order create'), 


| 


这 表示 为 order_create 视图 的 URL 路 径 。 编 辑 myshop 应 用 程序 的 urls.py 文件 ， 并 


包含 以 下 路 径 。 注意 ， 需 要 将 其 置 于 shop.urls 路 径 之 前 。 


path('orders/', include('orders.urls', namespace='orders')), 


编辑 cart 应 用 程序 的 cart/detail.html 文件 ， 并 查看 下 列 代码 行 : 


<a href="#" class="button">Checkout</a> 


添加 order_create URL， 如 下 所 示 : 


<a href="{% url "orders:order create" %}" class="button"> 
Checkout 

</a> 

户 现在 可 以 从 购物 车 详细 信息 页 面 导航 到 订单 表单 。 对 于 订 自 

定义 相关 模板 。 对 此 ， 在 orders 应 用 程序 目录 中 生成 下 列 文件 结构 : 


渍 
A 
a 


交 ， 我 们 仍 需 要 
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templates/ 
orders/ 
order/ 
create.html 
created.html 


编辑 orders/order/create.html 模板 ， 并 包含 下 列 代码 : 


{% extends "shop/base.html" %} 


{% block title %} 
Checkout 
{% endblock %} 


{% block content $%} 
<hl>Checkout</h1> 


<div class="order-info"> 
<h3>Your order</h3> 
<ul> 
{% for item in cart $%} 
< 
{{ item.quantity }}x {{ item.product.name }} 
<span>${{ item.total price }}</span> 
</1i> 
{ 当 endfor $} 
</ul> 
<p>Total: ${{ cart.get total price }}</p> 
</div> 


<form action="." method="post" class="order-form"> 
4 torm ans p PY 
<p><input type="submit" value="Place order"></p> 
{$$ csrf token 当 } 
</form> 
{$$ endblock $} 


上 述 模 板 显 示 了 购物 车 中 的 全 部 商品 以 及 订单 提交 表单 。 
编辑 orders/order/created.html 模板 并 添加 下 列 代码 : 


{$$ extends "shop/base.html" %} 


{% block title %} 
Thank you 


ws 


启动 Web 开发 
车 中 加 入 一 组 商品 ， 
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$$ endblock $$} 


% block content %} 

<hl>Thank you</h1l> 

<p>Your order has been successfully completed. Your order number is 
<strong>{{ order.id }}</strong>.</p> 

% endblock %} 


当 订 单 成 功 创建 后 ， 将 显示 上 述 模板 。 


民 务 器 并 跟踪 新 文件 。 在 浏览 器 中 打开 http://127.0.0.1:8000/， 向 购物 
进入 结算 页 面 ， 如 图 7.10 所 示 。 


Your cart: 3 items, $112.2 


Checkout 


First name: 


Last name: 


Address: 


Postal code: 


City: 


Your order 


。 1x Tea powder $21.2 
» 2xRedtea $91.0 


Total: $112.2 


图 7.10 


利用 有 效 数 据 填 充 上 述 表单 ， 并 单 击 Place order 按钮 。 随 后 将 生成 表单 ， 并 显示 如 


图 7.11 所 示 的 成 功 页 面 。 
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Thank you 


Your order has been successfully completed. Your order number is 1. 


图 7.11 


下 面 将 访问 管理 站 点 。 


7.4 利用 Celery 启动 异步 任务 


视图 中 执行 各 项 任务 将 对 响应 时 间 产 生 一 定 的 影响 。 在 许多 场合 下 ， 可 能 需要 尽快 地 
向 用 户 返 回响 应 结果 ， 同 时 令 服务 器 以 异步 方式 执行 某 些 处 理 任务 。 这 对 于 较为 耗 时 的 处 
理 或 者 故障 处 理 较 为 重要 ， 同 时 可 能 需要 使 用 到 重 试 策略 。 例 如 ， 视 频 共享 平台 支持 用 户 
的 上 传 操作 ， 但 需要 较 长 的 时 间 对 上 传 视频 进行 转 码 。 其 间 ， 网 站 可 能 会 向 用 户 返 回 一 条 
消息 ， 并 通知 他 们 转 码 过 程 很 快 将 会 开始 ， 同 时 以 异步 方式 对 视频 进行 转 码 。 另 一 个 例子 
是 向 用 户 发 送 电子 邮件 。 如 果 网 站 从 某 个 视图 中 发 送 电子 邮件 通知 ，SMTP 连接 可 能 会 出 
现 故 障 ， 或 者 减缓 响应 速度 。 对 于 代码 执行 的 阻塞 问题 ， 启 动 异 步 任务 将 变 得 越发 重要 。 

Celery 是 一 种 分 布 式 任务 队列 并 可 处 理 大 量 的 消息 。 除 了 实时 处 理 之 外 ，Celery 还 支 
持 任务 调度 。 据 此 ， 不 仅 可 方便 地 生成 、 执 行 异 步 任务 ， 还 可 对 其 进行 调度 ， 从 而 在 特 
定时 间 点 对 其 加 以 执行 。 

读者 可 访问 http://docs.celeryproject.org/en/latest/index.html 以 查看 Celery 文档 。 


7.4.1 安装 Celery 


本 节 将 安装 Celery 并 将 其 整合 至 项 目 中 。 对 此 ,可 使 用 下 列 命令 以 及 pip 安装 Celery: 
pip install celery==4.1.0 


Celery 需要 使 用 一 个 消息 代理 ， 以 处 理 来 自 外 部 资源 的 请 求 。 该 消息 代理 将 消息 发 
送 至 Celery worker， 并 在 接收 任务 时 对 其 进行 处 理 。 下 面 讨论 消息 代理 的 安装 过 程 。 


7.4.2 安装 RabbitMQ 


对 于 Celery 消息 代理 ， 存 在 多 种 可 选 方案 ， 包 括 键 值 存储 〈 如 Redis) 或 者 消息 系统 
(如 RabbitMQ) 。 鉴 于 RabbitMQ 可 视 作 Celery 的 推荐 消息 代理 ， 下 面 将 配置 基于 
RabbitMQ 的 Celery。 
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在 Linux 环境 下 ， 可 利用 下 列 命令 在 Shell 中 安装 RabbitMQ: 
apt-get install rabbitmq 


而 对 于 macOS 或 Windows 环 境 下 的 RabbitMQ 安 装 ,读者 可 访问 https:/www .rabbitmq. 
com/download.html 获取 其 单机 版 本 。 
在 RabbitMQ 安装 完毕 后 ， 在 Shell 中 利用 下 列 命令 启动 RabbitMQ: 


rabbitmq-server 


对 应 输出 结果 如 下 所 示 : 


Starting broker... completed with 10 plugins. 


此 时 ，RabbitMQ 处 于 运行 状态 并 可 接收 相关 消息 
7.4.3 ”向 项 目 中 添加 Celery 


对 于 Celery 实例 ， 我 们 需要 提供 相应 的 配置 信息 。 在 myshop 应 用 程序 中 创建 新 的 
settings.py 文件 ， 将 其 命名 为 celery.py。 该 文件 中 包含 了 项 目的 Celery 配置 信息 ， 对 应 代 
码 如 下 所 示 : 


import os 
from celery import Celery 


# set the default Django settings module for the 'celery' program. 
os.environ.setdefault ('DJANGO SETTINGS MODULE', 'myshop.settings') 


app = Celery('myshop') 


app.config from object('django.conf:settings', namespace='CELERY') 
app. autodiscover tasks () 
上 述 代码 将 执行 以 下 任务 : 
(1) 针对 Celery 命令 行程 序 ， 设 置 DJANGO_SETTINGS_MODULE 变量 。 
(2) 利用 app = Celery(myshop) 生 成 应 用 程序 实例 。 
(3) 利用 config from object0 方 法 加 载 项 目 设置 中 的 自 定义 配置 内 容 。namespace 属性 
设置 了 与 Celery 相关 的 设置 在 settings.py 文件 中 包含 的 前 级 。 通 过 设置 CELERY 命名 空 
间 ， 全 部 Celery 设置 须 在 其 名 称 中 包含 CELERY 前 级 〈 如 CELERY BROKER URL) 。 
(4) 最 后 ， 针 对 应 用 程序 ， 将 通知 Celery 自动 发 现 异步 任务 。Celery 将 查找 添加 至 
INSTALLED APPS 中 的 、 每 个 应 用 程序 目录 中 的 tasks.py 文件 ， 进 而 加 载 定 义 于 其 中 的 
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异步 任务 。 
下 面 将 导入 项 目 _init .py 文件 中 的 celery 模块 ， 以 确保 在 Django 启动 时 加 载 
Celery。 对 此 ， 编 辑 myshop/ ”init .py 文件， 并 向 其 中 添加 下 列 代码 : 


# import celery 
from .celery import app as celery app 


随后 即 可 针对 应 用 程序 实现 异步 任务 编程 。 
@ 注意; 

CELERY _ ALWAYS EAGER 设置 支持 以 异步 方式 于 本 地 执行 任务 ,而 不 是 将 其 发 送 
至 队列 中 。 这 对 于 单元 测试 ， 或 者 本 地 环境 下 执行 应 用 程序 ( 未 运行 Celery ) 十 分 有 用 。 


7.4.4 向 应 用 程序 中 添加 异步 任务 


当 用 户 提交 订单 后 ， 将 生成 一 个 异步 任务 并 向 其 发 送 电子 邮件 通知 。 常 见 的 做 法 是 
在 应 用 程序 目录 的 tasks 模块 中 包含 应 用 程序 的 异步 任务 。 

在 orders 应 用 程序 中 创建 新 文件 ， 并 将 其 命名 为 tasks.py，Celery 将 于 其 中 查找 异步 
任务 。 对 此 ， 可 向 该 文件 中 添加 下 列 代码 : 

from celery import task 


from django.core.mail import send mail 
from .models import Order 


@task 
def order created (order id) : 
mm 
Task to send an e-mail notification when an order is 
successfully created . 
mm 
order = Order.objects.get (id=order id) 
subject 'Order nr. {}'.format (order.id) 
message "Dear {},\n\nYou have successfully placed an order.\ 
Your order id is {}.'.format (order.first name, 
order .id) 


mail sent = send mail(subject, 
message, 
"adminemyshop .com'， 
[order .emaill]) 
return mail sent 
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通过 使 用 task 装饰 器 ， 此 处 定义 了 order created 任务 。 不 难 发 现 ，Celery 任务 仅 表 
示 为 一 个 利用 task 装饰 的 Python 函数 。 其 中 ，task 函数 接收 一 个 order id 参数 ， 一 般 建 
议 向 task 函数 传递 一 个 ID， 并 在 执行 任务 时 查找 对 象 。 这 里 使 用 了 Django 提供 的 
send_mailO 函 数 向 提交 订单 的 用 户 发 送 电子 邮件 通知 。 

第 2 章 曾 讨论 了 如 何 配置 Django 以 使 用 SMTP 服务 器 。 如 果 不 希望 配置 电子 邮件 设置 ， 
可 通知 Django 在 控制 台中 编写 电子 邮件 。 对 此 ， 可 在 settings.py 文件 中 添加 下 列 设置 : 


EMAIL BACKEND = "django.core.mail.backends.console.EmailBackend' 
© i: 
异步 任务 不 仅 适用 于 耗 时 的 处 理 过 程 , 还 适用 于 其 他 可 能 出 现 故 障 的 流程 ,这些 流 
程 不 需要 花费 太 多 时 间 来 执行 ， 但 可 能 出 现 连 接 故障 或 需要 使 用 重 试 策略 。 
下 面向 order_create 视图 中 添加 上 述 任务 。 编 辑 orders 应 用 程序 的 views.py 文件 ， 导 
当前 任务 ， 并 在 清空 购物 车 后 调用 order_ created 异步 任务 ， 如 下 所 示 : 


from .tasks import order created 


def order create (request): 


Ee 

if request.method == 'POST': 
' 
TE Form lis validatys 


Re 
cart.clear() 

# launch asynchronous task 
order created.delay (order .id) 


LE 
上 述 代码 调用 对 其 任务 的 delay() 方 法 ， 并 通 


至 队列 中 ， 并 通过 worker 执行 。 
打开 另 一 个 Shell 并 启动 项 目 中 的 Celery worker， 对 应 命令 如 下 所 示 : 


异步 方式 对 其 执行 。 该 项 任务 将 添加 


celery -A myshop worker -1 info 

Celery worker 当前 处 于 运行 状态 , 并 为 执行 相关 任务 做 好 了 准备 。 此 处 应 确保 Djang 
也 处 于 运行 状态 。 在 浏览 器 中 打开 http://127.0.0.1:8000/， 向 购物 车 中 添加 少量 商品 并 完 
成 订单 。 在 Shell 中 ， 将 启动 Celery worker， 对 应 输出 结果 如 下 所 示 : 


[2017-12-17 17:43:11,462: INFO/MainProcess] Received task: 
orders.tasks.order created[e990ddae-2e30-4e36-b0e4-78bbd4f2738e] 
[2017-12-17 17:43:11,685: INFO/ForkPoolWorker-4] Task 


第 7 章 ”构建 在 线 商店 “235 。 


orders.tasks.order created[e990ddae-2e30-4e36-b0e4-78bbd4f2738e] 
succeeded in 0.22019841300789267s: 1 


任务 执行 后 ， 用 户 将 会 接收 到 一 封 订单 电子 邮件 通知 。 


7.4.5 监视 Celery 


我 们 可 能 需要 对 所 执行 的 异步 任务 进行 监视 。 具 体 来 说 ，Flower 是 一 款 基 于 Web 的 
Celery 监视 工具 。 对 此 ， 可 通过 下 列 命令 安装 Flower: 


Pip install flower==0.9.2 
安装 完毕 后 ， 可 运行 项 目 目 录 中 的 下 列 命 令 启 动 Flower: 
celery -A myshop flower 


在 浏览 器 中 打开 http://localhost:5555/dashboard， 即 可 看 到 处 于 激活 状态 下 的 Celery 
worker 以 及 异步 任务 统计 数据 ， 如 图 7.12 所 示 。 


Flowel Jasks Broker Monitor 


Active: 0 : Failed: 0 


Worker Name a Retried Load Average 


celery@MacBook-Alr-de-Antonio.local 2.2,2.4, 2.36 


Showing 1 to 1 of 1 entries 


图 7.12 


读者 可 访问 https://flower.readthedocs.io/ 查 看 Flower 文档 。 
7.5 本 章 小 结 


本 章 构建 了 基本 的 在 线 商店 应 用 程序 ， 其 中 包括 商品 目录 以 及 基于 会 话 的 购物 车 功 
能 。 此 外 ， 本 章 还 实现 了 自 定义 上 下 文 处 理 器 ， 以 使 购物 车 可 用 于 模板 中 ， 以 及 一 个 提 
交 订 单 所 用 的 表单 。 最 后 ， 本 章 还 讲解 了 如 何 利用 Celery 启动 异步 任务 。 

第 8 章 将 介绍 如 何 将 支付 网 关 整 合 至 在 线 商 店 程序 中 、 向 管理 站 点 添加 自 定义 操作 、 
导入 CSV 格式 的 数据 ， 以 及 动态 生成 PDF 文件 。 


第 8 章 管理 支付 操作 和 订单 


第 8 章 创建 了 基本 的 在 线 商店 应 用 程序 ， 其 中 包含 了 商品 目录 和 购物 车 。 除 此 之 外 ， 
还 讨论 了 如 何 利用 Celery 启动 异步 任务 。 本 章 将 介绍 如 何 将 支付 网 关 整 合 至 站 点 中 ， 以 使 用 
户 可 通过 信用 卡 支付 。 本 章 还 将 扩展 管理 站 点 ， 并 将 订单 导出 为 CSV 进而 打印 PDF 发 票 。 
本 章 主 要 涉及 以 下 内 容 : 
将 支付 网 关 整 合 至 项 目 中 。 
口 将 订单 导出 为 CSV 文件 。 
口 ”针对 管理 站 点 创建 自 定义 视图 。 
口 动态 生成 PDF 发 票 。 


口 


8.1 整合 支付 网 关 


支付 网 关 可 在 线 处 理 支 付 行为 。 当 使 用 支付 网 关 时 ， 可 对 客户 的 订单 进行 管理 ， 并 
将 支付 处 理 委托 至 安全 可 靠 的 第 三 方 ， 读 者 不 必 对 系统 中 的 信用 卡 处 理 问题 担忧 ， 稍 后 
将 会 对 此 进行 讨论 。 

我 们 将 整合 Braintree， 它 被 流行 的 在 线 服务 如 优 步 或 Airbnb 所 使 用 。Braintree 提供 
了 一 个 API， 人 允许 客户 使 用 信用 卡 、PayPal、Android Pay 和 Apple Pay 等 多 种 支付 方式 处 
理 在 线 支付 。 关于 Braintree 的 更 多 内 容 , 读者 可 访问 https://www.braintreepayments.com/。 

Braintree 提供 了 不 同 的 整合 选项 ， 其 中 最 为 简单 的 是 插入 式 〈drop-in) 集成 ， 其 中 
包含 了 预先 格式 化 的 支付 表单 。 然 而 ， 为 了 自 定义 结算 行为 和 体验 过 程 ， 我 们 将 采用 更 
加 高 级 的 托管 字段 (Hosted Fields) 集成 。 关 于 托管 字段 ， 读 者 可 访问 https://developers. 
braintreepayments.com/guides/hosted-fields/overview/javascript/v3 以 查看 更 多 内 容 。 

结算 页 面 上 的 某 些 付款 字段 (如 信用 卡号 、CVYV 号 或 到 期 日 ) 必须 被 安全 托管 。 托 
管 字段 集成 将 支付 网 关 域 中 的 结算 字段 进行 托管 ， 并 向 用 户 予 以 显示 ， 从 而 能 够 定制 支 
付 表单 的 外 观 ， 同 时 确保 符合 支付 卡 行业 〈PCI) 的 相关 要 求 。 


8.1.1 创建 Braintree 沙 箱 账 号 


我 们 需要 一 个 Braintree 账号 将 支付 网 关 集 成 至 站 点 中 。 下 面 创 建 一 个 沙 箱 账 号 ， 并 
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对 Braintree API 进行 测试 。 在 浏览 器 中 打开 https:Wwww.braintreepayments.com/， 图 8.1 
显示 了 对 应 的 表单 。 


Sign up for the sandbox 


Test Everything 
Braintree 


Entering our sandbox allows you to get a feel for the 
Braintree experience before applying for a merchant Where 23 pus beninons. Lo 


account or going to production. Spain 


Already in the sandbox? Sign in pe 


Try the sandbox 


图 8.1 
填写 详细 信息 后 将 生成 沙 箱 账号 ， 随 后 将 会 接收 到 一 封 来 自 Braintree 的 电子 邮件 ， 
其 中 包含 了 一 个 链接 以 完成 账户 设置 过 程 。 单 击 该 链接 ， 完 成 账号 的 后 续 设 置 工作 。 登 
录 https://sandbox.braintreegateway.com/login 后 ， 将 显示 如 图 8.2 所 示 内 容 ， 其 中 包含 了 
Merchant ID、 Private Key 和 Public Key。 


Sandbox Keys & Configuration 


Here are the keys to your Sandbox Account. Once you're ready to start taking payments with a production 


Braintree Account you'l| have to update your code, replacing these with your production Braintree Account keys. 


Merchant ID: 9xtfhm7sv733jznk 


Public Key: qBfxx6fwkjx8dfkw 


Private Key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXSXX 


图 8.2 
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根据 图 8.2 中 信息 ， 即 可 验证 针对 Braintree API 的 请 求 。 注意， 此 处 确保 Private Key 
的 私密 性 。 


8.1.2 安装 Braintree Python 模块 


Braintree 提供 了 Python 模块 ， 并 可 简化 其 API 的 处 理 过 程 ， 读 者 可 访问 https://github. 
comy/braintree/braintree python 查看 其 源 代 码 。 下 面 利用 braintree 模块 将 支付 网 关 整 合 至 
当前 项 目 中 。 

利用 如 下 命令 在 Shell 中 安装 braintree 模块 。 

Pip install braintree==3.45.0 

向 项 目的 settings.py 文件 中 添加 下 列 设置 内 容 : 


# Braintree settings 

BRAINTREE MERCHANT ID = "XXX" # Merchant ID 
BRAINTREE PUBLIC KEY = "XXX' # Public Key 
BRAINTREE PRIVATE KEY = "XXX" # Private key 


from braintree import Configuration, Environment 


Configuration.configure( 
Environment .Sandbox， 
BRAINTREE MERCHANT ID, 
BRAINTREE PUBLIC KEY, 
BRAINTREE PRIVATE KEY 
) 
这 里 ， 可 利用 读者 的 账号 替换 BRAINTREE MERCHANT ID、BRAINTREE_ 
PUBLIC KEY 和 BRAINTREE _ PRIVATE KEY 值 。 


© 注意 

对 于 沙 箱 的 整合 操作 ， 我 们 采用 了 Environment.Sandbox。 在 账号 创建 完毕 后 ， 需 
要 将 其 修改 为 Environment.Production。 对 于 产品 环境 ，Braintree 提供 的 新 的 Merchant 
ID 、Private Key 和 Public Key- 


下 面 将 支付 网 关 集 成 至 结算 处 理 过 程 中 。 
8.1.3 ”集成 支付 网 关 


结算 过 程 的 工作 方式 如 下 所 示 : 
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(1) 向 购物 车 加 入 商品 。 

(2) 对 购物 车 进行 结算 。 

(3) 输入 选项 卡 详细 信息 并 支付 。 

此 处 将 使 用 新 的 应 用 程序 对 支付 过 程 进行 管理 。 
程序 : 

python manage.py startapp payment 


编辑 项 目的 settings.py 文件 ， 并 向 INSTALLED_APPS 设置 中 添加 新 应 用 程序 ， 如 下 
所 示 : 
INSTALLED APPS = 上 


二 
"payment .apps .PaymentConfig', 


二 


用 下 列 命令 在 项 目 中 创建 新 的 应 


当前 ，payment 处 于 活动 状态 。 

在 客户 确定 订单 后 ， 需 要 将 其 重 定 向 至 付费 处 理 过 程 。 编 辑 orders 应 用 程序 的 
views.py 文件 ， 并 添加 下 列 导 入 语句 : 

from django.urls import reverse 

from django.shortcuts import render, redirect 


在 同一 文件 内 ， 查 看 order_create 视图 中 的 下 列 代码 行 : 


# launch asynchronous task 

order created.delay (order .id) 

return render (request, 
'orders/order/created.html', 
locals ()) 


并 替换 为 下 列 内 容 : 


# launch asynchronous task 

order created.delay (order.id) 

# set the order in the session 
request.session['order id'] = order.id 

# redirect for payment 

return redirect(reverse('payment:process')) 


利用 上 述 代码 ， 在 成 功 生 成 订单 后 ， 可 利用 order id 会 话 密 钥 设置 当前 会 话 中 的 订 
单 ID。 随 后 ， 将 用 户 重 定向 至 payment:process URL 〈 稍 后 将 对 此 加 以 实现 ) 。 
需要 注意 的 是 ， 对 于 队列 化 和 所 执行 的 order created 任务 ， 此 处 需要 运行 Celery。 
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每 次 创建 Braintree 中 的 订单 时 ， 将 会 生成 唯一 的 事务 标识 符 。 这 里 将 向 orders 应 


程序 的 Order 模型 中 加 入 新 的 字段 以 存储 事务 ID， 进 而 通过 关联 的 Braintree 事务 实现 相 


互 链接 。 
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编辑 orders 应 用 程序 的 models.py 文件 ， 并 向 Order 模型 中 加 入 下 列 字 段 : 


class Order (model1s.Model) : 


1 


braintree id = models.CharField (max_ length=150, blank=True) 


下 面 将 上 述 字段 与 数据 库 同步 。 对 此 ， 使 用 下 列 命令 生成 迁移 : 


Python manage.py makemigrations 


对 应 输出 结果 如 下 所 示 : 


Migrations for 'orders': 
orders/migrations/0002 order braintree id.py 
- Rdd field braintree id to order 


利用 下 列 命令 将 迁移 应 用 至 数据 库 中 : 


Python manage.py migrate 


对 应 输出 结果 如 下 所 示 : 


Applying orders.0002 order braintree id... OK 
当前 , 模型 变化 将 与 数据 库 同 步 。 接 下 来 , 即 可 针对 每 个 订单 存储 Braintree 事务 ID 。 
下 面 继续 讨论 支付 网 关 的 集成 操作 。 


托管 字段 集成 可 通过 自 定义 样式 和 布局 生成 支付 表单 。 
SDK， 将 以 动态 方式 向 对 应 页 面 添加 过 ame。 


通过 Braintree JavaScript 


该 过 ame 包含 了 托管 字段 支付 表单 。 当 客 


户 提交 表单 后 ， 托 管 字段 将 以 一 种 安全 的 方式 收集 信用 卡 详 细 信息 ， 并 尝试 对 其 进行 令 
牌 化 《〈tokenize) 。 若 操作 成 功 ， 可 将 生成 的 令 牌 nonce 发 送 到 视图 ， 以 便 使 用 Python 


Braintree 模块 进行 事务 处 理 。 


下 面 针对 支付 处 理 创建 一 个 视图 ， 全 部 结算 过 程 的 工作 方式 如 下 所 示 : 


(1) 在 视图 中 ， 客 户 端 令 牌 通过 braintree Python 模块 生成 。 该 令 牌 用 于 下 一 个 操作 
步骤 ， 进 而 实例 化 Braintree JavaScript 客户 端 ， 但 并 不 是 当前 支付 令 牌 nonce。 


(2) 视图 显示 结算 模板 。 
生成 包含 托管 支付 表单 字段 的 


生成 。 随 后 ， 我 们 将 该 令 牌 利 


该 模板 利用 客户 端 令 牌 加 载 Braintree JavaScript SDK， 并 


iframe。 


用 POST 请 求 发 送 至 当前 视图 


(3) 用 户 输入 信用 卡 详细 信息 并 提交 表单 。 支 付 令 牌 nonce 则 通过 Braintree JavaScript 


中 。 
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(4) 支付 视图 接收 令 牌 nonce， 同 时 结合 braintree Python 模块 创建 一 个 事务 。 


对 于 支付 结算 视图 ， 编 辑 payment 应 用 程序 的 viewspy 文件 ， 并 向 其 中 添加 下 列 代码 : 


import braintree 
from django.shortcuts import render, redirect, get object or 404 
from orders.models import Order 


def payment process (request): 
order id = request.session.get('order id') 
order = get object or 404 (Order, id=order id) 


if request.method == 'POST': 
# retrieve nonce 
nonce = request.POST.get ('payment method nonce', None) 
# create and submit transaction 
result = braintree.Transaction.salel({ 


'amount': '{:.2f}'.format (order.get total cost()), 
"payment method nonce': nonce, 
'options': { 


"submit for settlement': True 


} 
if result.is success: 
# mark the order as paid 
order.paid = True 
# store the unique transaction id 
order.braintree id = result.transaction.id 
order.save() 
return redirect('payment:done') 
Slsee 
return redirect('payment:canceled') 
else: 
# generate token 
client token = braintree.-ClientToken.generate () 
return render(request, 
'payment/process.html', 
{'order': order, 
'client token': client token}) 


payment_process 视图 管理 结算 处 理 过 程 。 在 该 视图 中 ， 考 察 下 列 操作 活动 : 
(1) 从 order id 会 话 密 钥 中 获取 当前 订单 表单 ， 该 表单 之 前 在 order_create 视 


| 


被 设置 。 
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(2) 针对 给 定 的 了 D 检索 Order 对 象 ， 如 果 未 发 现 该 对 象 ， 则 返回 404 Not Found 错误 。 
(3) 当 视 图 通过 POST 请 求 进行 加 载 时， 将 检索 payment method nonce， 并 利 ) 
braintree.Transaction.sale() 创 建 一 个 新 的 事务 。 这 里 将 向 其 传递 下 列 参 数 : 
口 amount: 表示 所 有 的 支付 客户 数量 。 
口 payment method nonce: 针对 当前 支付 , Braintree 针对 当前 支付 生成 令 牌 nonce， 
并 通过 Braintree JavaScript SDK 在 模板 中 被 创建 。 
口 “options: 发 送 包含 True 的 submit for _settlement 选项 , 使 得 事务 处 理 可 自动 提交 。 
(4) 如 果 事 务 被 成 功 处 理 ， 通 过 将 paid 属性 设置 为 True， 可 将 订单 标记 为 “已 支 
付 ”， 同 时 将 网 关 返 回 的 唯一 事务 ID 存储 于 braintree id 属性 中 。 如 果 支 付 成 功 ， 用 户 
将 被 重 定向 至 payment:done URL; 否则 重 定向 至 payment:canceled 。 
(5) 如 果 视 图 通过 GET 请 求 被 提交 ， 将 生成 一 个 客户 端 令 牌 ， 并 在 模板 中 加 以 使 
用 ， 从 而 实例 化 Braintree JavaScript 客户 端 。 
` 面 创建 基本 的 视图 ， 以 在 支付 成 功 ( 或 出 于 其 他 原因 支付 被 取消 ) 时 对 用 户 进行 
重 定向 。 对 此 ， 向 payment 应 用 程序 的 views.py 文件 中 添加 下 列 代码 : 
def payment done (request) : 
return render (request， 'payment/done .htm1l') 


def payment canceled (request) : 
return render (request， 'payment/canceled.html') 
在 payment 应 用 程序 目录 中 创建 新 文件 ， 将 其 命名 为 urls.py 并 添加 下 列 代码 ; 


from django.urls import path 
from . import views 


app name = 'payment' 


urlpatterns = [ 
path('process/', views.payment process, name='process'), 
path('done/', views.payment done, name='done'), 
path('canceled/', views.payment canceled, name='canceled'), 


] 

上 述 代码 表示 为 支付 流程 的 URL， 其 中 涵盖 了 以 下 URL 路 径 。 
口 “process: 该 视图 负责 处 理 当 前 支付 。 
口 done: 如 果 支 付 成 功 ， 该 视图 将 对 用 户 执行 重 定向 操作 。 

口 ”canceled: 如 果 支 付 不 成 功 ， 该 视图 将 对 用 户 执 行 重 定向 操作 。 
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编辑 myshop 应 用 程序 的 urlspy 文件 ， 针 对 payment 应 用 程序 添加 下 列 URL 路 径 : 


Urlpatterns = [ 
-es 
path('payment/', include('payment.urls', namespace='payment')), 
path('', include('shop.urls', namespace='shop')), 


] 
需要 注意 的 是 ， 需 要 将 上 述 代 码 置 于 shop.urls 路 径 之 前 ， 避 免 产 生 错 误 的 路 径 匹配 。 
在 payment 应 用 程序 目录 中 创建 下 列 文件 结构 : 
templates/ 
payment/ 
process.html 
done.html 
canceled.html 
编辑 payment/process.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{% extends "shop/base.html" %} 


{% block title %}Pay by credit card{% endblock %} 


{% block content %} 
<hl>Pay by credit card</h1l> 
<form action="." id="payment" method="post"> 


<label for="card-number">Card Number</label> 
<div id="card-number" class="field"></div> 


<label for="cvv">CVV</label> 
<div id="cvv" class="field"></div> 


<label for="expiration-date">Expiration Date</label> 
<div id="expiration-date" class="field"></div> 


<input type="hidden" id="nonce" name="payment method nonce" 
Value=""> 
{$$ csrf token $} 
<input type="submit" value="Pay"> 
</form> 
<!-- Load the required client component. —-> 
<script 
src="https://js.braintreegateway.com/web/3.29.0/js/client.min.js"></script> 
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<!-- Load Hosted Fields component. -> 
<script src="https://js.braintreegateway.com/web/3.29.0/js/hostedfields. 


min.js"></script> 
<script> 


Var form = 
var submit = 


document .querySelector ('#payment'); 
document .querySelector('input [type="submit"] '); 


braintree.client.createl({ 
authorization: '{{ client token }}" 


function (clientErr, clientIinstance) { 


}, 
if (clientErr) { 
console.error (clientErr); 


return; 


braintree.hostedFields.createl({ 
client: clientInstancey， 
styles: { 
"nput: tT font=-si2er: “ISpR 
nput- linvalidn: colors "red ys 
'input.valid': {'color': 'green'} 


}, 
fields: { 
number: {selector: 
cvv: {selector: '#cvv'}, 
expirationDate: {selector: 


'#card-number'}, 
'#expiration-date'} 


function (hostedFieldsErr, hostedFieldsInstance) { 


}, 
if (hostedFieldsErr) { 
console.error (hostedFieldsErr); 


return; 


submit.removeAttribute('disabled'); 


form.addEventListener('submit', function (event) { 


event .preventDefault (); 
hostedFieldsInstance.tokenize (function (tokenizeErr, payload) 


if (tokenizeErr) { 
console.error (tokenizeErr); 


return; 
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// set nonce to send to the server 
document .getElementById('nonce') .value = payload.nonce; 
// submit form 
document .getElementById('payment') .submit (); 
1D); 
}, false); 
DD); 
]}) 

</script> 

{% endblock %} 

上 述 代码 表示 为 当前 模板 ， 用 以 显示 支付 表单 并 处 理 支付 操作 。 其 中 ， 针 对 信 
输入 字段 (信用 卡号 、CVV 号 和 过 期 时 间 ) ， 定 义 了 <div> 容 器 ， 而 非 <input> 元 素 一 一 
体现 了 当前 字段 的 指定 方式 ，Braintree JavaScript 客户 端 在 过 ame 中 显示 对 应 字段 。 除 
之 外 , 代码 中 还 包含 了 名 为 payment _ method nonce 的 <input> 元 素 , 经 Braintree JavaScript 
客户 端 生成 后 ， 将 把 令 牌 nonce 发 送 至 当前 视图 中 。 

在 当前 视图 中 , 将 加 载 Braintree JavaScript SDK， 即 clientmin.js， 以 及 托管 字段 组 件 
hosted-fields min.js。 随 后 ， 将 执行 下 列 JavaScript 代码 : 

(1) 利用 braintree.client.create() 方 法 实例 化 Braintree JavaScript 客户 端 ， 其 中 使 用 了 
payment process 视图 生成 的 client token。 

(2) 利用 braintree.hostedFields.create() 方 法 实例 化 托管 字段 。 

(3) 针对 input 字段 自 定 义 CSS 样式 表 。 

(4) 针对 字段 card-number、cvv 和 expiration-date 指定 id 选择 器 。 

(5) 针对 表单 的 submit 操作 添加 事件 监听 器 。 当 提交 表单 时 ， 该 字段 将 通过 Braintree 
SDK 实现 令 牌 化 , 且 令 牌 nonce 设置 于 payment method nonce 字段 中 。 随后 提交 该 表单 ， 
以 使 视图 接收 nonce 并 处 理 支付 行为 。 

编辑 payment/done .html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{g extends "shop/base.html" 委 } 


兵 区 六 


{ 当 block content 村 } 

<hl>Your payment was successful</h1> 

<p>Your payment has been processed successfully.</p> 
{gs endblock $} 


上 述 代码 表示 用 户 在 成 功 支付 后 被 重 定向 到 的 页 面 的 模板 。 
编辑 payment/canceled.html 模板 ， 并 向 其 中 添加 下 列 代码 : 
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{$$ extends "shop/base-html" 当 } 
{% block content 要 } 
<hl>Your payment has not been processed</hl> 


<p>There was a problem processing your payment.</p> 
{g endblock %} 


车 交易 未 成 功 ， 上 述 代码 表示 用 户 被 重 定向 的 页 面 模板 。 下 面 尝试 实现 支付 测试 过 程 。 
8.1.4 支付 的 测试 操作 


打开 Shell， 并 利用 下 列 命令 运行 RabbitMQ: 

rabbitmq-server 

打开 另 一 个 Shell， 并 利用 下 列 命令 在 项 目 目录 中 启用 Celery worker: 

celery -A myshop worker -1 info 

再 次 打开 Shell， 利 用 下 列 命 令 启 动 开发 服务 器 : 

python manage.py runserver 

在 浏览 器 中 打开 http://127.0.0.1:8000/， 向 购物 车 中 添加 某 些 商品 ， 并 填写 结算 表单 。 
当 单 击 PLACE ORDER 按钮 时 ， 订 单 将 持久 化 至 数据 库 中 ， 订 单 ID 将 保存 至 当前 会 话 
中 。 最 后 ， 用 户 将 被 重 定 向 至 支付 处 理 页 面 中 。 

支付 处 理 页 面 根据 会 话 检索 订单 ， 并 在 过 ame 中 显示 托管 字段 ， 如 图 8.3 所 示 。 

Pay by credit card 


Card Number 


CVV 


Expiration Date 


图 8.3 
读者 可 查看 HTML 源 代码 以 了 解 所 生成 的 HTML 内 容 。 
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Braintree 提供 了 一 个 有 效 / 无 效 信用 卡 列表 以 对 各 种 情形 进行 测试 。 读 者 可 访问 
https://developers.braintreepayments.com/guides/credit-cards/testing-go-live/python 查看 供 测 
试 使 用 的 信用 卡 列表 。 此 处 将 使 用 VISA 测试 卡 4111 1111 1111 1111, 并 返回 一 个 成 功 的 
测试 结果 。 此 外 ， 还 将 使 用 CVV 123 以 及 一 个 过 期 时 间 〈 例 如 12/24) 进行 测试 ， 对 应 
结果 如 图 8.4 所 示 。 


Pay by credit card 


Card Number 
4111111111111111 


Cw 


123 


Expiration Date 
12120 


Pay 


图 8.4 
单 击 Pay 按钮 ， 对 应 结果 如 图 8.5 所 示 。 


Your payment was successful 


Your payment has been processed successfully. 


图 8.5 


图 8.5 中 显示 , 当前 交易 已 被 成 功 处 理 。 下面 利 用 账号 登录 https://sandbox.braintreegateway. 
com/login， 在 Transactions 下 方 ， 将 会 看 到 如 图 8.6 所 示 的 交易 结果 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/admin/orders/order/， 相 关 订 单 己 标记 为 Paid， 
同时 还 包含 了 所 关联 的 Braintree 交易 ID， 如 图 8.7 所 示 。 
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Transaction Date Payment 


Information 


一 一 
/05/2018 07:45: itted F A 

02/05/2018 07:45:23 Submitted For 1s 21,20 € EUR 

PM CST Settlement 411111*eewe*1111 


图 8.6 


Paid 


Braintree id: 2bwkx5b6 


图 8.7 
至 此 ， 我 们 实现 了 一 个 支付 网 关 进 而 可 处 理 与 信用 卡 相关 的 问题 。 


8.1.5 注意 事项 


当 对 具体 环境 进行 测试 时 ， 需 要 访问 https:/www.braintreepayments.com 并 注册 真实 
账号 。 当 移 至 产品 开发 环境 中 时 ， 需 要 在 项 目的 settings.py 文件 中 修改 实际 的 环境 设置 ， 
并 使 用 braintree.Environment.Production 对 当前 环境 进行 设置 。 对 此 ， 读 者 可 访问 
https://developers. braintreepayments.com/start/go-live/python 以 了 解 更 多 内 容 。 


8.2 ”将 订单 导出 为 CSV 文件 


某 些 时 候 ， 可 能 需要 将 模型 中 的 信息 导出 至 一 个 文件 中 ， 进 而 在 其 他 系统 中 对 其 加 以 
导入 。 对 此 ， 一 种 应 用 较为 广泛 的 数据 导入 /导出 格式 是 CSV〈 即 逗号 分 隔 值 ) 。CSV 文 
件 是 一 种 纯 文 本 文件 ， 其 中 包含 了 多 条 记录 。 通 常 ， 每 行 包 含 一 条 记录 ， 并 采用 一 些 分 隔 
符 〈 通 常 是 文字 逗号 ) 分 隔 记录 字段 。 下 面 将 自 定义 当前 站 点 ， 并 将 订单 导出 为 CSV 文件 。 

Django 提供 了 多 种 选项 可 对 管理 站 点 进行 自 定义 。 此 处 将 调整 对 象 列表 视图 ， 并 包 
含 自 定义 管理 操作 。 

管理 操作 的 工作 方式 描述 如 下 : 用 户 从 对 象 列表 页 面 中 选取 对 象 (包含 多 个 复 选 框 )， 
随后 选取 一 项 操作 并 在 所 有 的 选取 条 目 上 了 予以 执行 。 图 8.8 显示 了 相关 操作 在 管理 站 点 中 
所 处 的 位 置 。 


人 提示 


创建 自 定义 管理 操作 可 使 管理 人 员 一 次 性 地 向 多 个 元 素 添加 操作 。 
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Select user to change 


Q 


Actioni v Ne Go | 0of1 selected 
ee " 


uM ApprEss 


admin 


图 8.8 

下 面 编写 一 个 常规 函数 ， 并 接收 下 列 参数 以 创建 一 个 自 定义 操作 。 

口 显示 当前 操作 行为 的 ModelAdmin。 

口 ”作为 HttpRequest 实例 的 当前 请 求 对 象 。 

口 ”、 用 户 所 选 对 象 的 QuerySet。 

当 对 应 操作 由 管理 站 点 触发 时 ， 该 函数 将 被 执行 。 

接 下 来 创建 一 个 自 定义 管理 操作 , 并 作为 CSV 文件 下 载 订单 列表 。 对 此 , 编辑 orders 
应 用 程序 的 admin.py 文件 ， 并 在 OrderAdmin 类 之 前 添加 下 列 代码 : 


import csV 
import datetime 
from django.http import HttpResponse 


def export to csv(modeladmin, request, queryset): 
opts = modeladmin.model. meta 
response = HttpResponse (Content type='text/csv') 
response['Content-Disposition'] = 'attachment;'\ 
'filename={}.csv'.format (opts.verbose name) 
writer = csv.writer (esponse) 


fields = [field for field in opts.get fields() if not 
field.many to many and not field.one to many] 

# Write a first row with header information 
writer.writerow([field.verbose name for field in fields]) 
# Write data rows 
for obj in queryset: 

data row = [] 

for field in fields: 
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value = getattr (obj, field.name) 
if isinstance(value, datetime.datetime): 
value = value.strftime ('%d/%m/%Y') 
data row.append (value) 
writer.writerow (data row) 
return response 
export to csv.short description = 'Export to CSV' 
上 述 代码 将 执行 下 列 任务 : 
(1) 创建 HttpResponse 实例 (包含 了 一 个 自 定义 的 text/csv 内 容 类 型 ) ， 并 通知 浏 
览 器 响应 结果 须 视 为 一 个 CSV 文件 。 此 外 ， 还 添加 了 一 个 Content-Disposition 头 ， 表 明 
HTTP 响应 包含 了 一 个 绑 定 文件 。 
(2) 创建 一 个 在 response 对 象 上 编写 的 CSV writer 对 象 。 
(3) 通过 模型 的 meta 选项 的 get_fields0 方 法 ， 动 态 获取 model 字段 。 此 处 将 排除 
多 对 多 和 一 对 多 关系 。 
(4) 编写 一 个 包含 字段 名 称 的 数据 头 行 。 
(5) 遍历 给 定 的 QuerySet， 并 针对 QuerySet 返回 的 每 个 对 象 编写 一 个 数据 行 。 由 于 
CSV 输出 值 须 为 一 个 字符 串 ， 因 而 此 处 将 对 datetime 对 象 进行 格式 化 。 
(6) 设置 函数 的 short_description 属性 ， 并 以 此 自 定义 模板 中 对 应 操作 的 显示 名 称 。 
上 述 内 容 创 建 了 通用 的 管理 操作 ， 并 可 将 此 添加 至 任意 ModelAdmin 类 中 。 
最 后 ， 向 OrderAdmin 类 中 添加 新 的 export_to_csv 管理 行为 ， 如 下 所 示 : 
class OrderAdmin (admin.ModelAdmin): 
; 
actions = [export to _csv] 
在 浏览 器 中 打开 http://127.0.0.1:8000/admin/orders/order/, 图 8.9 显示 了 相应 的 管理 操 
作 行为 。 


Select order to change 


Action: | Export to CSV 外 Go | 1of19 selected 


ID FIRSTNAME LASTNAME 。 EMAIL ADDRESS 
Antonio Melé antonio.mele@gmail.com Bank Street 


Django Reinhardt email@domain.com Music Street 
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选择 一 些 订单 ， 并 从 下 拉 列 表 框 中 选择 Export to CSV 操作 ， 然 后 单 击 Go 按钮 。 随 
后 ， 浏 览 器 将 下 载 名 为 order.csv 的 CSV 生成 文件 。 利 用 文本 编辑 器 打开 该 文件 ， 将 会 看 
到 包含 以 下 格式 的 内 容 ， 其 中 包含 了 一 个 数据 头 行 ， 以 及 每 个 所 选 Order 对 象 的 数据 行 。 

ID,first name,last name,email,address,postal 

code,city,created, updated, paid, braintree id 


3,Antonio,Melé,antonio.mele@gmail.com,Bank Street,WS 
J11, London, 25/02/2018,25/02/2018, True, 2bwkx5b6 


不 难 发 现 ， 管 理 操作 的 创建 过 程 较为 直观 。 关 于 基于 Django 的 CSV 文件 生成 操作 ， 
读者 可 访问 https://docs.djangoproject.com/en/2.0/howto/outputting-csv/ 以 了 解 更 多 内 容 。 


8.3 ”利用 自 定义 视图 扩展 管理 站 点 


在 某 些 场 合 下 ， 可 能 希望 通过 配置 ModelAdmin、 创 建 管理 操作 和 禾 盖 管理 模板 来 定 
制 管 理 站 点 。 对 此 ， 需 要 创建 一 个 自 定义 管理 视图 。 当 采用 自 定义 视图 时 ， 可 构建 任意 所 
需 的 功能 项 。 需 要 注意 的 是 ， 仅 管理 人 员 可 访问 视图 ， 并 通过 扩展 管理 模板 维护 其 外 观 。 

下 面 创 建 一 个 自 定义 视图 并 显示 与 订单 相关 的 信息 。 编 辑 orders 应 用 程序 的 views.py 
文件 ， 并 向 其 中 添加 下 列 代码 : 

from django.contrib.admin.views.decorators import staff member required 


from django.shortcuts import get object or 404 
from .models import Order 


Q@staff member required 
def admin order detail (request, order id) : 
order = get object or 404(Order, id=order id) 
return render (request, 
"admin/orders/order/detail.html', 
{'order': order}) 


staff member required 装饰 器 检查 请 求 页 面 的 用 户 的 is_active 和 is_staff 字段 是 否 设 
置 为 Tme。 在 该 视图 中 , 将 获取 一 个 包含 给 定 ID 的 Order 对 象 , 并 通过 模板 显示 该 订单 。 
编辑 orders 应 用 程序 的 urlspy 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 


path("'admin/order/<int:order id>/', views.admin order detail, 
name="'admin order detail'), 
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在 orders 应 用 程序 的 templates/ 目 录 中 生成 下 列 文件 结构 : 


admin/ 
orders/ 
order/ 
detail.html 


编辑 detail.htm 模板 ， 并 向 其 中 添加 下 列 内 容 : 


{% extends "admin/base site.html" %} 
{%$ load static %} 


上 
Tn 


{% block extrastyle %} 

<link rel="stylesheet" type="text/css" href="{% static "css/admin.css" 
i 
{% endblock %} 


{% block title %} 
Order {{ order.id }} {{ block.super }} 
{$$ endblock %} 


{ block breadcrumbs $%} 
<div class="breadcrumbs"> 
<a href="{% url "admin:index" %}">Home</a> &rsaquo; 
<a href="{% url "admin:orders order changelist" %}">Orders</a> 
&rsaquo; 
<a href="{% Url "admin:orders order change" order.id %}">Order {{ 
order.id }}</a> 
&rsaquo; Detail 
</div> 
{s endblock %$} 


{% block content %} 
<hl>order {{ order.id }}</hl> 
<ul class="object-tools"> 
<1i> 
<a href="#" onclick="window.print();">Print order</a> 
</1i> 
</ul> 
<table> 
<tr> 
<th>Created</th> 
<td>{{ order.created }}</td> 
</tr> 
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E> 
<th>Customer</th> 
<td>{{ order.first name }} {{ order.last name }}</td> 
起 EE 
< 二 > 
<th>E-mail</th> 
<td><a href="mailto:{{ order.email }}">{{ order.email }}</a></td> 
</tr> 
<tr> 
<th>Address</th> 
<td>{{ order.address }}, {{ order.postal code }} {{ order.city }}</td> 
AEP 
<tr> 
<th>Total amount</th> 
<td>${{ order.get total cost }}</td> 
</tr> 
<tr> 
<th>status</th> 
<td>{% if order.paid %}Paid{% else %}Pending payment{% endif %}</td> 
</tr> 
</table> 


<div class="module"> 
<div class="tabular inline-related last-related"> 
<table> 
<h2>Items bought</h2> 
<thead> 
<tr> 
<th>Product</th> 
<th>Price</th> 
<th>Quantity</th> 
<th>Total</th> 
</tr> 
</thead> 
<tbody> 
{$$ for item in order.items.all %} 
<tr class="row{% cycle "1" "2" %}"> 
<td>{{ item.product.name }}</td> 
<td class="num">${{ item.price }}</td> 
<td class="num">{{ item.quantity }}</td> 
<td class="num">${{ item.get cost }}</td> 
</tr> 
{SS endfor 要 } 
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<tr class="total”"> 
<td colspan="3">Total</td> 
<td class="num">${{ order.get total cost }}</td> 
</tr> 
</tbody> 
</table> 
</div> 
</div> 
{%S endblock %} 


上 述 模 板 显 示 了 管理 站 点 上 的 订单 详细 信息 。 该 模板 扩展 了 Django 的 admin/base_ 
site.html 模板 , 其 中 包含 了 HTML 主 结构 以 及 管理 的 CSS 样式 。 这 里 将 加 载 css/admin.css 
自 定义 静态 文件 。 

为 了 使 用 静态 文件 , 我 们 需要 使 用 本 章 中 的 附加 代码 ， 并 复制 orders 应 用 程序 static/ 
目录 中 的 静态 文件 ， 将 其 添加 至 项 目 中 的 同一 位 置 处 。 

此 处 使 用 定义 于 父 模板 中 的 代码 块 ， 同 时 包含 我 们 自己 的 内 容 ， 进 而 显示 与 订单 和 
购买 商品 相关 的 信息 。 

当 希 望 扩展 某 个 管理 模板 时 ， 需 要 了 解 其 结构 并 识别 现 有 的 代码 块 。 对 此 ， 读 者 可 
访问 https://github.com/django/django/tree/2.0/django/contrib/admin/templates/admin 以 查看 
全 部 管理 模板 。 

必要 时 ， 还 可 重 载 某 个 管理 模板 。 对 此 ， 可 将 其 复制 至 持 有 同一 相对 路 径 和 文件 名 
的 templates 目录 中 。Django 管理 站 点 采用 了 自 定义 模板 ， 而 非 默认 模板 。 

最 后 ， 在 管理 站 点 的 列表 显示 页 面 中 添加 指向 每 个 对 象 的 链接 。 对 此 ， 编 辑 orders 
应 用 程序 的 admin.py 文件 ， 并 向 其 中 添加 下 列 代码 (位 于 类 之 前 〉: 

from django.urls import reverse 

from django.utils.safestring import mark safe 


def order detail (obj): 
return mark safe('<a href="{}">View</a>'.format( 
reverse('orders:admin order detail', args=[obj.id]))) 

上 述 函 数 接收 一 个 Order 对 象 作为 参数 ， 并 返回 一 个 指向 admin_order_detail URL 的 
HTML 链接 。 默 认 状 态 下 ，Django 将 对 HIML 输出 自动 转 义 ， 因 而 须 通 过 mark safe 函 
数 防止 自动 转 义 。 

他 提示 

使 用 mark safe 函数 可 防止 HTML 转 义 。 当 使 用 mark safe 时 ,确保 转 义 来 自用 户 的 

输入 ， 以 避免 跨 站 点 脚本 。 
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编辑 OrderAdmin 类 并 显示 对 应 链接 : 


class OrderAdmin (admin.ModelAdmin): 
list display = ['id’', 
'first name', 
Ee 
"updated' 
order detaill] 


在 浏览 器 中 打开 http://127.0.0.1:8000/admin/orders/order/, 此 时 ,每 行 包含 了 一 个 View 
链接 ， 如 图 8.10 所 示 。 


PAID CREATED UPDATED ORDER DETAIL 


© Feb. 6, 2018, 1:35 a.m. Feb. 6, 2018, 1:45a.m. View 


图 8.10 
单 击 订单 的 View 链接 ， 并 加 载 自 定义 订单 页 面 ， 对 应 结果 如 图 8.11 所 示 。 


Django administration 


Home » Orders , Order 19，Detail 


Order 19 


Created Feb. 6, 2018, 1:35 a.m. 
Customer Antonio Melé 

E-mail antonio.mele@gmail.com 
Address Jazz Street, 28027 Madrid 
Total amount $21.2 


Status Paid 


ltems bought 


PRODUCT 
Tea powder 


Total 


图 8.11 


第 8 章 管理 支付 操作 和 订单 “2ST: 


8.4 动态 生成 PDF 发 票 


前 述 内 容 实现 了 结算 和 支付 系统 ， 并 可 针对 每 个 订单 生成 PDF 发 票 。 相 应 地 ， 存 在 
多 个 Python 库 可 生成 PDF 文件 。 其 中 ，Reportlab 则 是 一 种 较为 流行 的 Python PDF 文件 
构建 库 。 针 对 基于 Reportlab 的 PDF 文件 输出 方式 , 读者 可 访问 https://docs.djangoproject. 
com/en/2.0/howto/outputting-pdf/ 以 了 解 更 多 信息 。 

多 数 时候 ， 需 要 向 PDF 文件 中 添加 自 定义 样式 和 格式 ， 从 而 可 方便 地 显示 HTML 模 
板 ， 将 其 转换 为 一 个 PDF 文件 ， 以 使 Python“ 远 离 ” 显 示 层 。 下 面 将 采用 这 一 方案 并 利 
用 Django 生成 PDF 文件 。 除 此 之 外 ， 我 们 还 将 使 用 到 WeasyPrint。WeasyPrint 是 一 个 
Python 库 ， 并 可 从 HTML 模板 中 生成 PDF 文件 。 


8.4.1 安装 WeasyPrint 


首选 需要 针对 操作 系统 设置 WeasyPrint 的 依赖 关系 ， 读 者 可 访问 http://weasyprint.org/ 
docs/install/#platforms 以 了 解 更 多 信息 。 随 后 ,可 利用 下 列 命令 并 通过 pip 安装 WeasyPrint: 


Pip install WeasyPrint==0.42.3 


8.4.2 创建 PDF 模板 


我 们 需要 使 用 到 一 个 HTML 文档 作为 WeasyPrint 的 输入 内 容 ， 此 外 ， 还 将 生成 一 个 
HTML 模板 ， 利 用 Django 对 其 进行 显示 ， 并 将 其 传递 至 WeasyPrint 中 以 创建 PDF 文件 。 

在 orders 应 用 程序 的 templates/orders/order/ 目 录 中 创建 一 个 新 的 模板 文件 , 将 其 命名 
为 pdfhtml 并 添加 下 列 代码 : 


<html> 
<body> 
<hl>My Shop</h1> 
<p> 
Invoice no. {{ order.id }}</br> 
<span class="secondary"> 
{{ order.created|ldate:"M d, Y" }} 
</span> 
</p> 


<h3>Bill to</h3> 
<p> 
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{{ order.first name }} {{ order.last name }}<br> 
{{ order.email }}<br> 
{{ order.address }}<br> 
{{ order.postal code }}, {{ order.city }} 
</p> 


<h3>Items bought</h3> 
<table> 
<thead> 
<tr> 
<th>Product</th> 
<th>Price</th> 
<th>Quantity</th> 
<th>Cost</th> 
</tr> 
</thead> 
<tbody> 
{$$ for item in order.items.all $%} 
«tr Class= "now CYLle "LY m2 
<td>{{ item.product.name }}</td> 
<td class="num">${{ item.price }}</td> 
<td class="num">{{ item.quantity }}</td> 
<td class="num">${{ item.get cost }}</td> 
2 
{$$ endfor S$} 
<tr Class="total> 
<td colspan="3">Total</td> 
<td class="num">${{ order.get total cost }}</td> 
</tr> 
</tbody> 
</table> 
<span class="{% if order.paid %}paid{% else %}pending{% endif %}"> 
{% if order.paid %}Paid{% else %}Pending payment{% endif %} 
</span> 
</body> 
</html> 


上 述 代 码 表示 为 PDF 发 票 的 模板 。 在 该 模板 中 ,将 显示 全 部 订单 详细 信息 ， 以 及 一 个 
包含 各 种 商品 的 HIML <table> 元 素 。 此外, 还 将 包含 一 条 消息 , 以 显示 订单 是 否 已 被 支付 。 


8.4.3 显示 PDF 文件 


本 节 将 创建 一 个 视图 , 并 利用 管理 站 点 对 现 有 订单 生成 PDF 发 票 。 对 此 , 编辑 orders 
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应 用 程序 目录 中 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.conf import settings 

from django.http import HttpResponse 

from django.template.loader import render to string 
import weasyprint 


@staff member required 
def admin order pdf (request, order id) : 
order = get object or 404 (Order, id=order id) 
html = render to string('orders/order/pdf.html', 
{'order': order}) 
response = HttpResponse (Content type='application/pdf') 
response['Content-Disposition'] = 'filename=\ 
"order {}.pdf"'.format (order.id) 
weasyprint .HTML (string=html) .write pdf (response, 
stylesheets=[weasyprint.CSS( 
settings.STATIC_ ROOT + "css/pdf.css')]) 
return response 


该 视图 针对 某 个 订单 生成 一 个 PDF 发 票 。 此 处 使 用 staff member required 装饰 器 确 
保 只 有 管理 人 员 可 访问 该 视图 。 这 里 使 用 了 包含 给 定 ID 的 Order 对 象 ， 并 通过 Django 
提供 的 render_to_string0) 函 数 显示 orders/order/pdf.html。 经 显示 后 的 HTML 将 保存 至 html 
变量 中 。 随 后 生成 了 一 个 新 的 HttpResponse 对 象 ， 同 时 指定 了 application/pdf 内 容 类 型 并 
包含 了 Content-Disposition 头 ， 进 而 确定 对 应 的 文件 名 。 另 外 ,还 使 用 了 WeasyPrint 并 通 
过 显示 后 的 HTML 代码 生成 一 个 PDF 文件 , 同时 将 该 文件 写 入 HttpResponse 对 象 中 。 随 
后 ， 我 们 使 用 了 静态 文件 css/pdf.css， 并 将 CSS 样式 表 添 加 至 已 生成 的 PDF 文件 中 。 通 
过 STATIC ROOT 设置 ， 可 通过 本 地 路 径 对 其 进行 加 载 。 如 果 缺 失 了 样式 表 ， 可 将 位 于 
shop 应 用 程序 static/ 目 录 中 的 静态 文件 复制 至 项 目的 同一 位 置 处 。 

考虑 到 需要 使 用 STATIC_ROOT 设置 ， 因 而 须 将 其 添加 至 当前 项 目 中 ， 这 也 表示 为 
静态 文件 所 处 的 项 目 路 径 。 编 辑 myshop 项 目的 settings.py 文件 ， 并 添加 下 列 设置 内 容 : 

STATIC ROOT = os.path.join(BASE DIR, 'static/') 

随后 运行 下 列 命 令 : 

python manage.py collectstatic 


对 应 输出 结果 如 下 所 示 : 


120 static files copied to 'code/myshop/static' . 
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collectstatic 命令 将 应 用 程序 中 的 所 有 静态 文件 复制 至 STATIC ROOT 设置 中 所 定义 
的 目录 中 ,这 使 得 每 个 应 用 程序 可 通过 包含 其 自身 的 static/ 目 录 提 供 自己 的 静态 文件 。 除 
此 之 外 ， 还 可 在 STATICFILES_DIRS 设置 中 设置 额外 的 静态 文件 。 当 执行 collectstatic 
时 ， 设 置 于 STATICFILES_DIRS 列表 中 的 全 部 目录 也 将 复制 至 STATIC ROOT 目录 中 。 
当 再 次 执行 collectstatic 时 ， 将 会 被 询问 是 否 希望 覆盖 现 有 的 静态 文件 。 
编辑 orders 应 用 程序 目录 中 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 
urlpatterns = [ 
| 
path('admin/order/<int:order id>/pdf/', 
Views.admin order pdf, 
name='admin order pdf'), 


] 


下 面 针 对 Order 模型 编辑 管理 列表 显示 页 面 ， 并 针对 每 个 结果 添加 指向 PDF 文件 的 
链接 。 编 辑 orders 应 用 程序 的 admin.py 文件 ， 并 在 OrderAdmin 类 之 前 添加 下 列 代码 ; 
def order pdf (obj): 
return mark safe('<a href="{}">PDF</a>'.format( 


reverse('orders:admin order pdf', args=[obj.id]))) 
order pdf.short description = 'Invoice' 


如 果 针 对 可 调用 对 象 指定 了 一 个 short_description 属性 , Django 会 将 其 作为 列 名 加 以 
使 用 。 
下 面 将 order_ pdf 添加 至 OrderAdmin 类 的 list_display 属性 中 ， 如 下 所 示 : 
class OrderAdmin (admin.ModelAdmin): 
list display = ['id', 
ee 


order detail, 
order pdf] 


在 浏览 器 中 打开 http://127.0.0.1:8000/admin/orders/order/， 每 行 应 均 包含 一 个 PDF 链 
接 ， 如 图 8.12 所 示 。 

针对 任意 项 点 单 击 PDF 链接 ， 对 
于 尚未 支付 的 订单 ， 可 以 看 到 一 个 生 Feb. 11, 2018, 3:17 p.m. View PDF 
成 后 的 PDF 文件 ， 如 图 8.13 所 示 。 

对 于 已 支付 的 订单 ， 将 会 看 到 如 
图 8.14 所 示 的 PDF 文件 。 


UPDATED ORDER DETAIL INVOICE 


第 8 章 管理 支付 操作 和 订单 


My Shop 


Invoice no. 16 


Bill to 


Antonio Mele 
antonio.mele@gmailcom 
Jazz Street 

28033, Madrid 


ltems bought 


图 8.13 


My Shop 


Invoice no, 19 


Billto 


Antonio Melé 
antonio.mele @gmail.com 
Jazz Street 

28027, Madrid 


ltems bought 


Product 


Tea powder 


Total 


图 8.14 


* POS 
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8.4.4 通过 电子 邮件 发 送 PDF 文件 


在 支付 成 功 后 ， 将 向 用 户 自动 发 送 一 封 电子 邮件 ， 其 中 包含 了 生成 的 PDF 文件 。 编 
辑 payment 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 导 入 语句 : 

from django .template.loader import render to string 

from django.core.mail import EmailMessage 

from django.conf import settings 

import weasyprint 

from io import BytesIO 


在 payment process 视图 中 ,在 order.save0 之 后 添加 下 列 代码 (包含 相同 的 缩 进 级 别 ); 


def payment Process (equest) : 


ee 
if request.method == 'POST': 
# 
if result.is success: 
# 
order .save() 
# create invoice e-mail 
subject = 'MY Shop - Invoice no. {}'.format(order.id) 
message = 'Please, find attached the invoice for your recent\ 
purchase.' 
email = EmailMessage (subject, 
message, 
"adminemyshop .com’', 
[order .email]) 
# generate PDF 
html = render to string( 'orders/order/pdf.html', {'order': 
order}) 


out = BytesIO() 
stylesheets=[weasyprint.css (settings .STRTIC_ROOT + 


'css/pdf.css')] 


weasyprint.HTML (string=htm1) .write pdf(out, stylesheets= 
stylesheets) 

# attach PDF file 

email.attach('order {}.pdf'.format (order.id), 
out.getvalue(), 
'application/pdf') 

# send e-mail 

email.send() 
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return redirect('payment:done') 
else: 
return redirect('payment:canceled') 
else: 
es 
这 里 使 用 了 Django 提供 的 EmailMessage 类 创建 email 对 象 。 随后 将 模板 设置 于 html 
变量 中 ， 并 根据 模板 生成 PDF 文件 ， 同 时 将 其 输出 至 BytesIO 实例 中 ， 该 实例 表示 为 一 
个 内 存 字 节 缓冲 区 。 接 下 来 。 利用 attach() 方 法 将 所 生成 的 PDF 文件 绑 定 至 EmailMessage 
对 象 上 ， 包 括 out 缓冲 区 中 的 内 容 。 最 后 一 步 则 是 发 送 电子 邮件 。 
需要 注意 的 是 ， 应 在 项 目的 settings.py 文件 中 确定 SMTP 设置 ， 进 而 发 送 电子 邮件 。 
关于 SMTP 配置 示例 ， 读 者 可 参考 第 2 章 。 
读者 可 尝试 实现 一 个 新 的 支付 过 程 ， 并 在 电子 邮件 中 接收 PDF 发 票 


8.5 本 章 小 结 


本 章 讨 论 了 如 何 将 支付 网 关 整 合 至 项 目 中 、 自 定义 Django 管理 站 点 ， 以 及 以 动态 方 
式 生 成 CSV 和 PDF 文件 。 

第 9 pe Django 项 目的 国际 化 和 本 地 化 问题 。 此 外 ， 还 将 讨论 如 何 构建 优惠 券 
系统 以 及 商品 推荐 引擎 。 
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第 8 章 学 习 了 如 何 将 支付 网 关 整 合 至 项 目 中 , 同时 还 介绍 了 CSV 和 PDF 文件 的 生成 
方式 。 本 章 将 向 在 线 商 店 应 用 程序 中 加 入 优惠 券 系 统 。 此 外 ， 我 们 还 将 解决 国际 化 和 本 
地 化 问题 ， 并 尝试 构建 一 个 推荐 系统 。 

本 章 主要 涉及 以 下 内 容 : 
创建 优惠 券 系统 ， 以 对 商品 进行 打折 。 

对 项 目 进行 国际 化 处 理 。 

使 用 Rosetta 处 理 翻译 问题 。 
基于 django-parler 的 翻译 模块 。 
构建 商品 的 推荐 系统 。 


OOODODO 


9.1 创建 优惠 券 系统 


许多 在 线 商店 都 会 向 顾客 发 放 优惠 券 ， 顾 客 可 以 在 购物 时 兑换 折扣 。 在 线 优惠 券 通 
常 包含 一 个 发 送 至 用 户 的 代码 ， 在 特定 的 时 间 范 围 内 有 效 。 其 间 ， 该 代码 可 以 被 一 次 或 
多 次 兑换 。 

本 章 将 针对 在 线 商店 应 用 程序 构建 一 个 优惠 券 系统 ， 其 中 ， 优 惠 券 在 特定 时 间 范 围 
内 对 客户 有 效 ， 且 不 会 对 兑换 次 数 进行 限制 。 此 外 ， 优 惠 券 对 购物 车 中 的 全 部 商品 均 为 
有 效 。 针 对 这 一 功能 ， 我 们 需要 创建 一 个 模型 存储 优惠 券 代 码 、 有 效 的 时 间 范 围 以 及 相 
应 的 折扣 。 

通过 下 列 命令 在 myshop 项 目 中 创建 新 的 应 用 程序 : 


python manage.py startapp coupons 


编辑 myshop 应 用 程序 中 的 settings.py 文件 ， 并 将 该 应 用 程序 添加 至 INSTALLED_ 
APPS 设置 中 ， 如 下 所 示 ; 
INSTALLED APPS = [ 
和 


"coupons .apps .CouponsConfig' ， 


WS 


前 ， 新 的 应 用 程序 在 Django 项 目 中 处 于 激活 状态 。 
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9.1.1 构建 优惠 券 模型 


下 面 开始 设置 Coupon 模型 。 对 此 ， 编 辑 coupons 应 用 程序 中 的 models.py 文件 ， 并 
向 其 中 添加 下 列 命 
from django.db import models 


from django.core.validators import MinVvalueValidator, \ 
MaxValueValidator 


class Coupon (models.Model): 
code = models.CharField (max length=50, 
unique=True) 
Valid from = models.DateTimeField() 
valid to models.DateTimeField() 
discount models.IntegerField!( 
validators=[MinValueValidator (0) ， 
MaxValueValidator (100)]) 
active = models.BooleanField() 


def Str (ele 
return self.code 
上 述 模型 用 于 存储 优惠 券 。 其 中 ，Coupon 模型 包含 了 下 列 字段 。 
口 code: 表示 客户 所 获取 的 代码 ， 进 而 在 购买 过 程 中 可 使 用 优惠 券 。 
口 valid from: 优惠 券 的 有 效 期 。 
口 ”valid_to: 优惠 券 的 截止 日 期 。 
口 discount: 表示 折扣 率 《〈 以 百分比 表示 ， 因 而 使 用 0 一 100 的 数值 ) 。 对 于 该 字 
段 ， 将 通过 一 个 验证 器 限制 所 接收 的 最 小 值 和 最 大 值 。 
口 active; 表示 为 一 个 布尔 值 ， 并 判断 优惠 券 是 否 处 于 激活 状态 。 
运行 下 列 命令 ， 针 对 coupons 应 用 程序 创建 初始 迁移 : 


Python manage.py makemigrations 


对 应 输出 结果 如 下 所 示 : 


Migrations for 'coupons ' : 
coupons/migrations/0001 initial.py: 
- Create model Coupon 


随后 执行 下 列 命令 应 用 迁移 结果 : 


python manage.py migrate 
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对 应 输出 结果 如 下 所 示 : 


Applying coupons.0001 initial... OK 
下 面向 管理 站 点 添加 Coupon 模型 。 对 此 ， 编 辑 coupons 应 用 程序 的 admin.py 文件 ， 
并 向 其 中 添加 下 列 代码 : 


from django.contrib import admin 
from .models import Coupon 


class CouponAdmin (admin.ModelAdmin): 
list display = ['code', ‘valid from', 'valid to', 
'discount', 'active'] 
list filter = ['active', 'valid from', "valid to'] 
search fields = ['code'] 
admin.site.register (Coupon, CouponAdmin) 


当前 ，Coupon 模型 注册 于 管理 站 点 中 。 确 保利 用 python manage.py runserver 运行 本 
地 服务 器 。 在 浏览 器 中 打开 http://127.0.0.1:8000/admin/coupons/coupon/add/， 对 应 表单 如 
图 9.1 所 示 。 


[Dtslalelog:Telna lll de WELCOME, ADMIN, VIEW SITE / CHANGE PASSWORD / LOG OUT 
Home ,Coupons » Coupons » Add coupon 
Add coupon 

Code: 


Valid from: 


图 9.1 
填写 上 述 表 单 ， 并 创建 包含 有 效 日 期 的 新 优惠 券 。 确 保 选 中 Active 复 选 框 并 单 击 
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SAVE 按钮 。 


9.1.2 ”在 购物 车 中 使 用 优惠 券 


当前 ， 我 们 可 存储 新 的 优惠 券 、 执 行 查询 操作 以 获取 现 有 的 优惠 券 。 对 于 客户 来 说 ， 
需要 一 种 方法 可 在 购物 车 中 使 用 优惠 券 ， 该 功能 包含 以 下 内 容 : 

(1) 用 户 向 购物 车 中 添加 商品 。 

(2) 用 户 在 表单 中 输入 优惠 券 代 码 ， 该 代码 显示 于 购物 车 详细 页 面 中 。 

(3) 当 用 户 输入 优惠 券 代 码 并 提交 表单 后 ， 将 据 此 查询 已 有 的 优惠 券 。 另 外 ， 还 需 
要 检测 优惠 券 代 码 与 用 户 输入 的 代码 (active 属性 为 True) 是 否 匹配 ， 以 及 当前 日 期 是 否 
位 于 valid from 和 valid to 值 之 间 。 

(4) 若 存 在 相应 的 优惠 券 ， 将 其 存储 至 用 户 的 会 话 中 并 显示 购物 车 ， 包 括 商品 折扣 

(5) 当 用 户 提交 订单 后 ， 可 将 优惠 券 保存 到 指定 的 订单 中 。 

在 coupons 应 用 程序 目录 中 创建 新 文件 ， 将 其 命名 为 forms.py 并 添加 下 列 代码 ， 


from django import forms 


class CouponApPP1LYForm (forms .Form) : 
code = forms .CharField() 


上 述 表单 用 于 输入 优惠 券 代 码 。 编 辑 coupons 应 用 程序 中 的 views.py 文件 ， 并 向 其 
中 添加 下 列 代码 : 


from django.shortcuts import render, redirect 

from django.utils import timezone 

from django.views.decorators.http import require POST 
from .models import Coupon 

from .forms import CouponApplyForm 


@require POST 
def coupon apply (request): 
now = timezone.now() 
form = CouponApplyForm (request .POST) 
EE FO0rm ls valid(): 
code = form.cleaned data['code'] 
try: 
coupon = Coupon.objects.get (code iexact=code, 
valid from lte=now, 
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valid to gte=now, 
active=True) 


request.session['coupon id'] = coupon.id 
except Coupon.DoesNotExist: 
request.session['coupon id'] = None 


return redirect('cart:cart detail') 


coupon_ apply 视图 对 优惠 券 进行 验证 ， 并 将 其 存储 于 用 户 会 话 中 。 此 处 针对 该 视图 


使 


准 而 


Django 的 timezone.now() 获 得 当前 日 期 ， 并 与 valid_from 和 valid_to 字段 进行 比较 ， 旧 


(1) 利用 提交 数据 实例 化 CouponApplyForm 表单 ， 并 检测 该 表单 的 有 效 性 。 
(2) 对 于 有 效 表单 ， 将 获取 用 户 输入 的 code〈 源 自 表 单 的 cleaned_data 字典 ) 。 


后 根据 指定 代码 尝试 检索 Coupon 对 象 。 此 处 使 用 iexact 字段 查找 ， 并 执行 大 小 写 敏感 的 


匹配 操作 。 另 外 ， 优 惠 券 应 处 于 激活 状态 (active=Trme〉 且 日 期 有 效 。 这 里 使 月 


别 执行 le《〈 小 于 或 等 于 ) 和 gte〈 大 于 或 等 于 ) 字段 查找 操作 。 


建 


(3) 在 用 户 会 话 中 存储 优惠 券 ID 。 
(4) 将 用 户 重 定向 至 cart_detail URL， 并 显示 包含 所 用 优惠 券 的 购物 车 。 


coupon_apply 视图 需要 使 用 到 一 个 URL 路 径 。 对 此 ， 在 coupons 应 用 程序 目录 中 


-个 新 文件 ， 将 其 命名 为 urlspy， 并 向 其 中 添加 下 列 代 码 : 


from django.urls import path 
from . import views 


app name = "coupons' 


urlpatterns = [ 
path('apply/', views.coupon apply, name='apply'), 
] 


随后 ， 编 辑 myshop 项 目的 urls py 主 文件 ， 同 时 包含 coupons URL， 如 下 所 示 : 


urlpatterns = [ 

汗 
path('coupons/', include('coupons.urls', namespace='coupons')), 
path('', include('shop.urls', namespace='shop')), 


] 
需要 注意 的 是 ， 应 将 该 路 径 置 于 shop.urls 路 径 之 前 。 
接 下 来 ， 编 辑 cart 应 用 程序 的 cartpy 文件 ， 并 添加 下 列 导 入 语句 : 


from coupons .model1s import Coupon 


了 require POST 装饰 器 ， 并 将 其 限制 为 POST 请 求 。 在 该 视图 中 ， 将 执行 下 列 任务 : 


随 


> 


J 
分 


创 
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在 Cart 类 中 _init 0) 方法 的 结尾 处 添加 下 列 代码 ， 并 根据 当前 会 话 初始 化 优惠 券 : 


class Cart (object): 
def init (self, request): 
‘ 
# store current applied coupon 
self.coupon id = self.session.get('coupon id') 


上 述 代码 尝试 从 当前 会 话 中 获取 coupon id 会 话 密 钥 ， 并 将 其 值 存储 于 Cart 对 象 中 。 
下 面向 Cart 对 象 中 添加 下 列 方 法 : 
class Cart (object) : 
二 
@property 
def coupon(self): 
if self.coupon id: 
return Coupon.objects.get(id=self.coupon id) 


return None 


def get discount(self): 


if self.coupon: 
return (self.coupon.discount / Decimal('100')) \ 


* self.get total price() 
return Decimal('0') 


def get total price after discount (self): 
return self.get total price() - self.get discount() 


上 述 方法 的 工作 方式 如 下 所 示 。 
将 coupon() 方 法 定义 为 property。 如 果 购 物 车 包含 了 coupon id 属性 ， 则 返回 包 


回 
含 指 定 ID 的 Coupon 对 象 。 

口 ”get_discount0: 如 果 购 物 车 中 包含 了 一 张 优 惠 券 ， 将 检索 其 折扣 率 ， 并 返回 从 购 
物 车 总 金额 中 扣除 的 金额 。 

口 get total_ price _after_ discount0: 在 扣除 get_discount() 方 法 返回 的 金额 后 ， 返 回 


购物 车 的 总 金额 。 
Cart 类 现在 准备 处 理应 用 于 当前 会 话 的 优惠 券 ， 并 使 用 相应 的 折扣 。 

下 面 将 优惠 券 系统 置 入 购物 车 的 详细 视图 中 。 编 辑 cart 应 用 程序 的 views.py 文件 ， 
并 在 文件 开始 处 添加 下 列 导入 语句 : 


from coupons .forms import CouponApplyForm 


接 下 来 ， 编 辑 cart_detail 视图 并 向 其 中 添加 新 表单 ， 如 下 所 示 : 
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= 


def cart detail (request): 
cart = Cart (request) 
for item in cart: 
item['update quantity form'] = CartAddProductForm( 
initial={'quantity': item['quantity'], 
"update": True}) 
coupon apply_ form = CouponApplyForm() 


return render(request, 
'cart/detail.html', 
Car CArt 
'Coupon apply form': coupon apply form}) 


编辑 cart 应 用 程序 的 cart/detail.html 模板 ， 并 查看 下 列 语句 : 


<tr colass="total”> 
<td>Total</td> 
<td colspan="4"></td> 
<td class="num">${{ cart.get total price }}</td> 
</tr> 
将 上 述 内容 蔡 换 为 下 列 代码 : 
{% if cart.coupon %} 
<tr class="snbtotal> 
<td>Subtotal</td> 
<td colspan="4"></td> 
<td class="num">${{ cart.get total pricelfloatformat:"2" }}</td> 
</tr> 
<tr> 
<td> 
"{{ cart.coupon.code }}" coupon 
({{ cart.coupon.discount }}% off) 
<Atd> 
<td colspan="4"></td> 
<td class="num neg"> 
— ${{ cart.get discount|floatformat:"2" }} 
</td> 
SEES 
{ 当 endif 要 } 
<tr class="total"> 
<td>Total</td> 
<td colspan="4"></td> 
<td class="num"> 
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${{ cart.get total price after discount|floatformat:"2" }} 
</td> 
<x/Er> 


上 述 代 码 用 于 显示 一 张 可 选 的 优惠 券 及 其 折扣 率 。 如 果 购 物 车 中 包含 了 一 张 优惠 券 ， 
将 显示 第 一 行 ， 其 中 包含 了 作为 小 计 的 购物 车 的 总 数量 。 随 后 采用 第 二 行 显示 应 用 于 当 
前 购物 车 上 的 优惠 券 。 最 后 ， 通 过 调用 cart 对 象 上 的 get_total_price_after_discount() 方 法 
显示 总 价 和 折扣 。 
在 同一 文件 中 ， 在 </table> HTML 标签 后 包含 下 列 代码 : 
<p>Apply a coupon:</p> 
<form action="{% url "coupons:apply" $%}" method="post"> 
{{ coupon apply form }} 
<input type="submit" value="Apply"> 
{% csrf token $%} 
</form> 


这 将 显示 输入 优惠 券 代码 的 代码 ， 并 将 其 应 用 于 当前 购物 车 上 。 
在 浏览 器 中 打开 http:/127.0.0.1:8000/， 向 购物 车 中 添加 一 件 商品 ， 在 表单 中 输入 优 
惠 券 代码 以 使 用 刚刚 生成 的 优惠 券 。 此 时 ， 购 物 车 中 将 显示 优惠 券 折 扣 ， 如 图 9.2 所 示 。 


Yourshopping cart 


Remove Unitprice 


"SUMMER" coupon (10% of 
Total 


Apply a coupon: 


Code: 


Continue shopping 


图 9.2 


下 面向 采购 过 程 的 下 一 个 步骤 中 添加 一 张 优 惠 券 。 对 此 ， 编 辑 orders 应 用 程序 的 
orders/order/create html 模板 ， 并 查看 下 列 代码 行 : 
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<ul> 
{% £for item in cart %} 
<1i> 
{{ item.quantity }}x {{ item.product.name }} 
<span>${{ item.total price }}</span> 
< LS 
{$$ endfor 要 } 
</ul> 


将 上 述 内容 蔡 换 为 下 列 代码 : 


<ul> 
{$$ for item in cart $%} 
<1i> 
{{ item.quantity }}x {{ item.product.name }} 
<span>${{ item.total pricel|floatformat:"2" }}</span> 
RAE 
{% endfor %} 
{% if cart.coupon %} 
天 9 
"{{ cart.coupon.code }}" ({{ cart.coupon.discount }}% off) 
<span>- ${{ cart.get discount|floatformat:"2" }}</span> 
< 
% endif %} 
</ul> 


痢 ， 订 单 概要 内 容 应 该 包括 所 用 的 优惠 券 〈 如 果 存 在 的 话 ) 。 查 看 下 列 代 码 行 : 
<p>Total: ${{ cart.get total price }}</p> 

并 将 上 述 内容 蔡 换 为 下 列 代码 行 : 

<p>Total: ${{ cart.get total price after_ discount|floatformat:"2" }}</p> 


据 此 ， 总 价格 可 通过 优惠 券 的 折扣 加 以 计算 。 在 浏览 器 中 打开 http://127.0.0.1:8000/ 


orders/create/， 此 时 ， 包 含 所 用 优惠 券 的 订单 概要 内 容 如 图 9.3 所 示 。 


Your order 


。 1x Tea powder $21.20 
。 "SUMMER" (10% off) - $2.12 


Total: $19.08 


图 9.3 
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目前 ， 用 户 可 将 优惠 券 应 用 于 购物 车 中 。 然 而 ， 在 用 户 结算 购物 车 时 创建 的 订单 
我 们 仍然 需要 存储 优惠 券 信 息 。 


9.1.3 在 订单 中 使 用 优惠 券 


UD 


下 面 将 存储 用 于 每 个 订单 中 的 优惠 券 信息 。 首先 , 需要 调整 Order 模型 并 存储 所 关联 
的 Coupon 对 象 〈 如 果 存 在 ) 。 

编辑 orders 应 用 程序 中 的 models.py 文件 ， 并 向 其 中 添加 下 列 导 入 语句 : 

from decimal import Decimal 


from django .core.validators import MinvalueValidator, \ 
MaxValueValidator 


from coupons.models import Coupon 
随后 ， 向 Order 模型 中 加 入 下 列 字 段 : 


class Order (model1s.Model) : 
a 
coupon = models.ForeignKey (Coupon, 
related name='orders', 
null=True, 
blank=True, 
on _delete=models.SET NULL) 
discount = models.IntegerField(default=0, 


validators=[MinValueValidator (0), 

MaxValueValidator (100)]) 

上 述 各 个 字段 可 存储 订单 的 《可 选 ) 优惠 券 ， 以 及 该 优惠 券 包含 的 折扣 百分比 。 这 

-折扣 值 存储 于 所 关联 的 Coupon 对 象 中 ， 但 我 们 将 它 包含 在 Order 模型 中 ， 以 便 在 优惠 

券 被 修改 或 删除 时 保存 它 。 此 处 将 on_delete 设置 为 models.SET_NULL: 如 果 订 单 被 删除 ， 
coupon 字段 将 设置 为 Null。 

这 里 需要 生成 一 个 迁移 操作 ,以 包含 Order 模型 的 新 字段 。 在 命令 行 工 具 中 运行 下 列 

命令 : 


Python manage.py makemigrations 


对 应 输出 结果 如 下 所 示 : 


Migrations for 'orders': 
orders/migrations/0003 auto 20180307 2202.py: 


第 9 章 扩展 在 线 商店 应 用 程序 “275。 


- Rdd field coupon to order 
- RMdd field discount to order 


利用 下 列 命令 应 用 上 述 迁 移 结果 : 

Python manage.PY migrate orders 

此 处 应 该 会 看 到 一 条 确认 信息 ， 表 明 新 的 迁移 已 经 被 应 用 。Order 模型 字段 的 变化 当 
前 已 被 同步 至 数据 库 中。 

返回 至 models.py 文件 ， 修 改 Order 模型 的 get total cost() 方 法 ， 如 下 所 示 : 


class Order (model1s.Model) : 
二 
def get total cost(self) : 
total cost = sum(item.get cost() for item in self.items.all()) 
return total cost - total cost * \ 
(self.discount / Decimal('100')) 


Order 模型 中 的 get_total_cost0 方 法 负责 计算 商品 折扣 (车 存在 〉。 

编辑 orders 应 用 程序 的 views.py 文件 ， 修 改 order_create 视图 ， 并 在 创建 新 订单 时 保 
存 所 关联 的 优惠 券 及 其 折扣 。 查 看 下 列 代码 行 : 

order = form.save() 


并 利用 下 列 代码 进行 蔡 换 : 

order = form.save (commit=False) 

if cart.coupon: 

order.coupon = cart.coupon 
order.discount = cart.coupon.discount 
order.save() 

上 述 新 代码 利用 OrderCreateForm 表单 的 save() 方 法 生成 了 一 个 Order 对 象 。 通 过 
commit=False， 可 避免 将 其 保存 至 数据 库 中 。 如 果 购 物 车 中 包含 了 一 张 优惠 券 ， 则 存储 所 
关联 的 优惠 券 及 其 折扣 。 随 后 ， 将 order 对 象 保存 至 数据 库 中 。 

利用 python manage.py runserver 命令 启动 开发 服务 器 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/， 尝 试 利用 创建 的 优惠 券 购买 商品 。 在 购买 过 
程 结束 后 ， 将 转 至 http://127.0.0.1:8000/admin/orders/order/， 进 而 查看 order 对 象 是 否 包 含 
了 优惠 券 及 其 折扣 ， 如 图 9.4 所 示 。 

除 此 之 外 ， 还 可 调整 管理 订单 的 细节 模板 以 及 订单 的 PDF 支票 ， 并 采用 与 购物 车 相 
同 的 方式 显示 折扣 。 

另外 ， 还 可 以 修改 管理 订单 详细 信息 模板 和 订单 PDF 账单 ， 以 显示 所 用 的 优惠 


洪 


Fs 
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相关 方法 与 购物 车 相同 。 


Braintree id: 


Coupon: 


Discount: 


ORDER ITEMS 


PRODUCT 


3 


Q Tea powder 


下 面 将 向 当前 项 目 中 添加 国际 化 机 制 。 


9.2 添加 国际 化 和 本 地 化 机 制 


Django 对 国际 化 和 本 地 化 提供 了 全 面 支持 ， 可 将 应 用 程序 翻译 为 多 种 语言 ， 并 处 理 
期 、 时 间 、 数 值 和 时 区 相关 的 地 区 设置 格式 。 国 际 化 和 本 地 化 之 间 的 差别 在 于 ， 国 
(通常 简写 为 il8n〉 是 针对 不 同 语言 和 地 区 的 软件 处 理 行为 ， 以 使 软件 不 会 固化 于 
的 语言 和 地 区 。 本 地 化 通常 简写 为 110n) 表示 为 软件 的 翻译 处 理 ， 并 将 其 应 用 于 
的 地 区 。Django 自身 通过 国家 化 框架 可 翻译 为 50 多 种 语言 。 


.1 ”Django 的 国际 化 处 理 


际 化 框架 可 方便 地 将 翻译 字符 串 标记 至 Python 代码 或 者 模板 中 ， 并 通过 GNU 


gettext 工具 集 生成 和 管理 消息 文件 。 这 里 ， 消 息 文件 表示 为 体现 菜 种 语言 的 纯 文本 文件 ， 


中 
息 文 


包含 了 应 用 程序 中 部 分 或 全 部 翻译 字符 串 ， 以 及 针对 某 种 语言 各 自 的 翻译 结果 。 消 
件 的 扩展 名 表示 为 po。 
当 翻 译 结束 后 ， 消 息 文 件 将 被 编译 ， 并 对 翻译 后 的 字符 串 提供 了 快速 处 理 。 相 应 地 ， 


编译 后 的 翻译 文件 包含 了 .mo 扩展 名 。 


1. 国际 化 和 本 地 化 设置 
Django 针对 国际 化 问题 提供 了 多 种 设置 ， 下 列 内 容 展 示 了 较为 常见 的 选项 : 
口 USE I18N 定义 为 一 个 布尔 值 ， 表 示 是 否 启用 了 Django 的 翻译 系统 。 默 认 状 态 
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下 该 值 为 True。 
口 USE LI0N 定义 为 一 个 布尔 值 , 表示 是 否 启用 了 本 地 化 格式 。 当 该 值 为 True 时 ， 
将 采用 本 地 化 格式 显示 日 期 和 时 间 。 默 认 状态 下 ， 该 值 设 置 为 False。 
口 USE TZ 表示 为 一 个 布尔 值 ， 用 于 确定 日 期 是 否 与 时 区 相关 。 当 利用 startproject 
命令 创建 项 目 时 ， 该 值 将 被 设置 为 True。 
口 LANGUAGE_ CODE 表示 项 目 默 认 的 语言 代码 ， 并 视 为 标准 的 语言 D 格式 ， 如 
美国 英语 的 en-us， 或 者 英国 英语 的 en-gp。 另 外 ， 该 设置 需要 将 USE I18N 设 
置 为 True 方 可 生效 。 读 者 可 访问 http://www.il8nguy.com/unicode/language- 
identifiers.html 以 查看 有 效 的 语言 ID 列表 。 
口 LANGUAGES 定义 为 一 个 元 组 ， 其 中 包含 了 有 效 的 项 目 语言 并 涵盖 了 语言 代码 
和 语言 名 称 。 读 者 可 访问 django.conf.global_settings 查看 有 效 的 语言 列表 。 当 在 
站 点 中 选择 了 一 种 语言 后 ， 可 将 LANGUAGES 设置 为 该 列表 的 子 集 。 
口 LOCALE PATHS 表示 为 一 个 字典 ，Django 于 其 中 查找 包含 项 目 翻 译 的 消息 文件 。 
口 TIME ZONE 表示 为 一 个 在 字符 串 ， 用 于 设置 项 目的 时 区 。 当 采用 startproject 
命令 创建 新 项 目 时 ， 该 字符 串 将 被 设置 为 UTC。 当 然 ， 读 者 可 将 其 设置 为 其 他 
任意 时 区 ， 如 Europe/Madrid。 
上 述 内 容 显 示 了 一 些 国际 化 和 本 地 化 设置 。 读 者 可 访问 https://docs.djangoproject.com/ 
en/2.0/ref/settings/#globalizationil8n-l10n 以 查看 完整 列表 。 
2. 国际 化 管理 命令 
Django 涵盖 了 下 列 管理 命 
口 “makemessages: 该 命令 运行 于 资源 树 上 ， 搜 索 针 对 翻译 内 容 所 标记 的 全 部 字符 串 ， 
或 者 更 新 locale 目录 中 的 .po 消息 文件 。 针 对 每 种 语言 , 将 生成 一 个 独立 的 po 文件 。 
口 ”compilemessages 将 现 有 的 .po 消息 文件 编译 为 .mo 文件 ， 并 用 于 检索 翻译 内 容 。 
对 此 ， 需 要 使 用 到 gettext 工具 包 创 建 、 更 新 和 编译 消息 文件 。 大 多 数 Linux 版 本 均 
包含 了 gettext 工具 包 。 对 于 macOS 环境 ， 最 简单 的 方式 是 通过 Homebrew〈 对 应 网 址 为 
https://brew.sh/) 并 使 用 brew install gettext 命令 进行 安装 。 此 外 , 可 能 还 需要 通过 brew link 
gettext--force 命令 对 其 进行 强制 链接 .对 于 Windows, 读者 可 访问 https://docs.djangoproject. 
com/en/2.0/topics/i18n/translation/#gettext-on-windows 并 遵循 其 中 的 各 项 步骤。 


3. 向 Django 项 目 中 加 入 翻译 功能 

下 面 考察 项 目 国际 化 处 理 过 程 。 对 此 ， 需 要 执行 以 下 任务 : 

(1) 在 Python 代码 和 模板 中 标记 用 于 翻译 的 字符 串 。 

(2) 运行 makemessages 命令 ， 创 建 或 更 新 包含 源 自 代 码 的 全 部 翻译 字符 串 的 消息 
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交 逢 。 
(3) 翻译 消息 文件 中 的 字符 串 ， 并 利用 compilemessages 管理 命令 对 其 进行 编译 。 
4. Django 如 何 确 定 当 前 语言 
Django 提供 了 一 个 中 间 件 ， 可 以 根据 请 求 数据 确定 当前 语言 ， 即 django.middleware. 
locale. LocaleMiddleware 中 的 LocaleMiddleware 中 间 件 ， 并 执行 下 列 任务 : 
(1) 若 采用 il8_pattermns， 也 就 是 说 ， 使 用 转换 后 的 URL 路 径 ， 则 查找 请 求 URL 中 
的 语言 前 级 ， 进 而 确定 当前 语言 。 
(2) 如 果 未 发 现 语言 前 级， 则 在 当前 用 户 会 话 中 查找 现 有 的 LANGUAGE_ 
SESSION KEY。 
(3) 如 果 当 前 语言 未 在 会 话 中 设置 ， 则 查找 基于 当前 语言 的 Cookie。 该 Cookie 的 
自 定义 名 称 位 于 LANGUAGE_COOKIE NAME 设置 中 。 默 认 条 件 下 ， 该 Cookie 的 名 称 
表示 为 django_language。 
(4) 如 果 未 发 现 Cookie， 将 搜索 请 求 的 Accept-Language HTTP 头 。 
(5) 如 果 Accept-Language 未 指定 语言 ，Django 将 使 用 定义 于 LANGUAGE_CODE 
设置 中 的 语言 。 
默认 状态 下 , 若 未 使 用 LocaleMiddleware, Django 将 使 用 定义 于 LANGUAGE_ CODE 
设置 中 的 语言 。 此 处 描述 的 处 理 过 程 仅 适用 于 使 用 该 中 间 件 。 


9.2.2 项 目的 国际 化 


下 面 开 始 针对 项 目 使 用 不 同 的 语言 ， 并 分 别 创建 在 线 商店 应 用 程序 的 英语 和 西班牙 语 
版 本 。 对 此 ， 编 辑 项 目的 settings.py 文件 ， 并 向 其 中 添加 LANGUAGES 设置 ， 如 下 所 示 : 
LANGUAGES = ( 
('en', 'English'), 
('es', 'Spanish'), 


) 

LANGUAGES 设置 包含 了 两 个 元 组 ， 并 由 语言 代码 和 名 称 构成 。 其 中 ， 语 言 代 码 特 
定 于 本 地 ， 如 en-us、en-gb 或 者 en〈 通 用 版 本 ) 。 根 据 这 一 设置 ， 当 前 应 用 程序 仅 包含 
英语 和 西班牙 语 . 如 果 未 自 定 义 LANGUAGES, 该 网 站 将 提供 Django 翻译 成 的 所 有 语言 。 

LANGUAGE_CODE 设置 如 下 所 示 : 


LANGUAGE CODE = 'en’' 


随后 向 MIDDLEWARE 设置 中 添加 'django.middleware.locale.LocaleMiddleware', 确保 
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该 中 间 件 位 于 SessionMiddleware 之 后 ， 其 原因 在 于 ，LocaleMiddleware 需要 使 用 会 话 数 
据 ， 此 外 ， 该 中 间 件 还 必须 放 在 CommonMiddleware 之 前 ， 因 为 后 者 需要 一 种 活动 语言 
来 解析 所 请 求 的 URL。MIDDLEWARE 设置 如 下 所 示 : 


MIDDLEWARE = [ 
'django.middleware.security.SecurityMiddleware', 
'django.contrib.sessions.middleware.SessionMiddleware', 
"django .middleware.locale.LocaleMiddleware', 
'django.middleware.common.CommonMiddleware', 


0 


] 
人 @@ 注意， 

中 间 件 类 的 顺序 十 分 重要 , 其 原因 在 于 , 每 个 中 间 件 均 依赖 于 之 前 执行 的 其 他 中 间 
件 所 设置 的 数据 。 中 间 件 以 MIDDLEWARE 中 的 出 现 顺 序 应 用 于 请 求 上 ， 而 以 相反 的 
顺序 应 用 于 响应 上 


在 项 目的 主 目录 中 创建 下 列 目录 结构 : 
locale/ 
en/ 
es/ 
其 中 ， 应 用 程序 的 消息 文件 位 于 locale 目录 中 。 再 次 编辑 settings.py 文件 ， 并 向 其 中 
添加 下 列 代码 : 
LOCALE PATHS = ( 
os.path.join (BASE DIR, 'locale/'), 
) 
LOCALE PATHS 设置 定义 了 Django 查找 翻译 文件 的 目录 。 首 先 出 现 的 区 域 设置 路 
径 优先 级 最 高 。 
当 使 用 项 目 目 录 中 的 makemessages 命令 时 ， 消 息 文件 将 在 所 生成 的 locale/ 目 录 中 被 
创建 。 然 而 ， 对 于 包含 locale/ 目 录 的 应 用 程序 来 说 ， 消 息 文件 也 将 在 该 目录 中 被 创建 。 


9.2.3 翻译 Python 代码 


当 翻译 Python 代码 中 的 文字 时 , 可 利用 django.utils.translation 中 的 gettext0 函 数 标记 
翻译 字符 串 。 该 函数 负责 对 消息 进行 翻译 并 返回 一 个 字符 串 。 对 应 规则 可 描述 为 : 将 该 
函数 作为 一 个 名 为 〈 下 画 线 字 符 ) 的 较 短 别名 导入 。 

读者 可 访问 https://docs.djangoproject.com/en/2.0/topics/il8n/translation/ 进 而 查看 与 翻 
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译 机 制 相关 的 文档 。 
1. 标准 翻译 
下 列 代码 显示 了 如 何 标记 一 个 翻译 字符 串 : 


from django.utils.translation import gettext as 


output = ("Text to be translated:") 
2. 延迟 翻译 


对 于 所 有 的 翻译 函数 ，Django 均 提 供 了 延迟 (lazy) 版 本 ， 对 应 后 级 名 为 lazy0。 当 
使 用 延迟 函数 时 ， 仅 在 访问 数值 时 字符 串 才 被 翻译 ， 而 非 调用 该 函数 时 《〈 即 延迟 翻译 ) 。 
当 标 记 为 翻译 的 字符 串 位 于 加 载 模块 时 的 执行 路 径 中 时 ， 延 迟 翻译 函数 即 会 发 挥 作 用 。 
@ 注意 : 

当 采 用 ettext lazy() 而 非 gettext() 时 ， 当 数值 被 访问 (而 不 是 函数 被 调用 ) 时 ， 字 符 
串 将 被 翻译 。Django 针对 所 有 的 翻译 函数 均 提供 了 延迟 版 本 。 


3. 包含 变量 的 翻译 
针对 翻译 所 标记 的 字符 串 可 包含 占 位 符 ， 进 而 涵盖 翻译 中 的 变量 。 下 列 代 码 显示 了 
使 用 占 位 符 的 字符 串 翻译 示例 : 


from django.utils.translation import gettext as 


month = ('April') 
day = "14" 
output = ('Today is %(month)s %(day)s') % {'month': month, 


'day': day} 
通过 使 用 占 位 符 , 我 们 可 记录 文本 变量 ,例如 , 上 述 示例 的 英文 翻译 结果 可 能 是 “Today 
is April 14”; 而 西班牙 语 版 本 则 表示 为 “Hoy es 14 de Abril”。 通 常 ， 当 翻译 字符 串 包含 
多 个 参数 时 ， 一 般 采 用 字符 串 插值 ， 而 不 是 位 置 插值 。 据 此 ， 即 可 记录 占 位 符 文本 。 
4. 翻译 的 名 词 复数 
对 于 名 词 复数 问题 ， 可 使 用 ngettext() 和 ngettext_lazy0 函 数 ， 根 据 表示 对 象 数量 的 参 
数 ， 此 类 函数 负责 处 理 单 、 复 数 问题 。 下 列 示例 展示 了 其 应 用 方式 : 


output = ngettext('there is %$(count)d product', 
"there are %S(count)d products', 
count) $$ {'count': count} 
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上 述 内 容 讨论 了 Python 代码 中 转换 文本 的 基本 知识 ， 下 面 将 翻译 操作 应 用 到 项 目 中 。 

5. 翻译 自己 的 代码 

编辑 项 目的 settings.py 文件 , 导入 gettext lazy0 函 数 , 并 按照 下 列 形式 修改 LANGUAGES 
设置 以 翻译 语言 名 称 : 


from django.utils.translation import gettext lazy as 


LANGUAGES = ( 
('en', ('English')), 
as SpanLish ds 
) 
此 处 使 用 了 gettext_lazy0 函 数 〈 而 不 是 gettext0 函 数 ) 以 避免 循环 导入 问题 ， 进 而 在 
访问 时 翻译 当前 语言 名 称 。 
打开 Shell 并 在 项 目 目 录 中 运行 下 列 命令 


django-admin makemessages --all 
对 应 输出 结果 如 下 所 示 : 


Processing locale es 
Processing locale en 


考察 locale/ 目 录 ， 其 中 包含 了 如 下 所 示 的 文件 结构 : 


en/ 
LC MESSAGES/ 
django.po 
es/ 
LC MESSAGES/ 
django.po 


针对 每 种 语言 创建 一 个 .po 文件 。 利用 文本 编辑 器 打开 es/LC_MESSAGES/django.po。 
在 文件 结尾 处 ， 可 以 看 到 下 列 代码 : 
#: myshop/settings.py:117 


msgid "English" 
msgstr "™ 


#: myshop/settings.py:118 
msgid "spanish" 
msgstr 


.282 。 Django 项 目 实例 精 解 〈 第 2 版 ) 


盖 了 以 下 两 个 字符 串 。 


口 msgid: 表示 出 现 于 源 代 码 中 的 翻译 字符 串 。 


每 个 翻译 字符 串 之 前 是 一 行 注释 ， 表 示 与 文件 和 行 数 相关 的 信息 。 每 项 翻译 内 容 涵 


口 msgstr: 表示 为 语言 翻译 ， 默 认 状 态 下 为 空 。 其 中 需要 针对 给 定 的 字符 串 输入 实 


际 翻译 内 容 。 


针对 给 定 的 msgid 字符 串 ， 填 写 msgstr 翻译 内 容 ， 妇 


#: myshop/settings.py:117 
msgid "English" 
msgstr "Inglées" 


#: myshop/settings.py:118 
msgid "spanish" 
msgstr "Espafiol" 


保存 修改 后 的 消息 文件 ， 打 开 Shell 并 运行 下 列 命令 : 


django-admin compilemessages 


如 果 一 切 顺 利 ， 对 于 输出 结果 如 下 所 示 : 


下 所 示 : 


Processing file django.po in myshop/locale/en/LC MESSAGES 
Processing file django.po in myshop/locale/es/LC MESSAGES 


上 述 输出 结果 显示 了 与 被 编译 的 消息 文件 相关 的 信息 。 再 次 考察 myshop 项 目的 


locale 目录 ， 对 应 文件 结构 如 下 所 示 : 


en/ 

LC MESSAGES/ 
django .mo 
django .po 

es/ 


LC MESSAGES/ 
django.mo 
django.po 
其 中 包含 了 针对 每 种 语言 生成 的 .mo 消息 文件 。 
下 面 


对 站 点 中 显示 的 模型 字段 名 称 进行 翻译 。 编辑 orders 应 上 


程序 中 的 models.py 文 


件 ， 对 于 Order 模型 字段 ， 添 加 针对 翻译 内 容 标记 的 名 称 ， 如 下 所 示 : 


from django.utils.translation import gettext lazy as _ 
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class Order (models .Model): 
first name = models.CharField(_('first name'), 
max length=50) 
last name = models.CharField(_('last name'), 
max length=50) 
email = models.EmailField(_('e-mail')) 
address = models.CharField(_('address')， 
max length=250) 
postal code = models.CharField(_('postal code'), 
max length=20) 
city = models.CharField(_('city'), 
max length=100) 
ee 


当 用 户 提 交 新 订单 时 ， 我 们 针对 所 显示 的 字段 加 入 了 相应 的 名 称 ， 其 中 包括 
: 意 的 是 ， 还 可 以 使 用 


first name、last name、email、address、postal code 和 city。 需 要 
verbose_name 属性 对 字段 进行 命名 。 

在 orders 应 用 程序 目录 中 创建 下 列 目录 结构 : 

locale/ 


en/ 
es/ 


通过 生成 locale 目录 ， 应 用 程序 的 字符 串 翻译 将 存储 于 该 目录 下 的 消息 文件 中 ， 而 
非 主 文件 中 。 通 过 这 一 方式 ， 可 针对 每 个 应 用 程序 生成 分 离 的 翻译 文件 。 

在 项 目 目录 中 打开 Shell 并 运行 下 列 命令 : 

django-admin makemessages --all 

对 应 输出 结果 如 下 所 示 : 


processing locale es 
processing locale en 


通过 文本 编辑 器 打开 order 应 用 程序 的 locale/es/LC_MESSAGES/django.po 文件 ， 将 会 
看 到 针对 Order 模型 的 翻译 字符 串 。 针 对 给 定 的 msgid 字符 串 , 填写 下 列 msgstr 翻译 内 容 : 
#: orders/models.py:10 


msgid "first name" 
msgstr "nombre" 


#: orders/models.py:11 
msgid "last name" 
msgstr "apellidos" 
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#: orders/models.py:12 
msgid "e-mail" 
msgstr "e-mail" 


#: orders/models.py:13 
msgid "address" 
msgstr "direccion" 


#: orders/models.py:14 
msgid "postal code" 
msgstr "codigo postal" 


#: orders/models.py:15 

msgid "city" 

msgstr "ciudad" 

待 添加 操作 完毕 后 ， 保 存 当 前 文件 。 

除了 文本 编辑 器 之 外 ， 还 可 使 用 Poedit 对 翻译 内 容 进行 编辑 。Poedit 是 一 球 翻译 编 
辑 软件 并 使 用 了 gettext， 且 支持 Linux、Windows 以 及 macOS X 环境 。 读 者 可 访问 
https://poedit.net/ 下 载 Poedit。 

除 此 之 外 ， 还 需要 对 项 目 表 单 进行 翻译 。orders 应 用 程序 的 OrderCreateForm 并 不 需 
要 被 翻译 ， 其 原因 在 于 ， 它 针对 表单 字段 标记 使 用 了 Order 字段 的 verbose_name 属性 。 
下 面 尝 试 对 cart 和 coupons 应 用 程序 的 表单 进行 翻译 。 

标记 cart 应 用 程序 目录 中 的 forms.py 文件 ， 向 CartAddProductForm 的 quantity 字段 
添加 一 个 label 属性 ， 并 于 随后 标记 该 字段 以 用 于 翻译 ， 如 下 所 示 : 

from django import forms 

from django.utils.translation import gettext lazy as _ 


PRODUCT QUANTITY CHOICES = [(i, str(i)) for i in range(1, 21)] 


class CartAddProductForm(forms.Form): 

quantity = forms.TypedChoiceField( 
choices=PRODUCT QUANTITY CHOICES, 
coerce=int, 
label=_('Quantity')) 

update = forms.BooleanField(required=False, 
initial=False, 
widget=forms .HiddenInput) 
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编辑 coupons 应 用 程序 的 forms.py 文件 ,并 翻译 CouponApplyForm 表单 ， 如 下 所 示 : 


from django import forms 
from django.utils.translation import gettext lazy as _ 


class CouponApplyForm (forms .Form) : 
code = forms.CharField (label=_('Coupon')) 


至 此 ， 我 们 针对 code 字段 添加 了 一 个 标记 以 用 于 翻译 。 
9.2.4 翻译 模板 


Django 提供 了 {% trans %} 和 {% blocktrans %} 模 板 标签 翻译 模板 中 的 字符 串 。 当 使 用 
翻译 模板 标签 时 ， 需 要 在 模板 上 方 添加 {% load il8n %} 以 对 其 进行 加 载 。 

1.{% trans %} 模 板 标签 

{% trans %} 模 板 标签 可 针对 翻译 标记 字符 串 、 常 量 或 者 变量 内 容 。 从 内 部 来 看 
Django 在 给 定 文本 上 执行 gettext0)， 这 也 体现 了 模板 中 翻译 字符 串 的 标记 方式 ， 如 下 所 示 : 

{$$ trans "Text to be translated" %} 

相应 地 ， 可 使 用 as 将 翻译 后 的 内 容 存 储 于 某 个 模板 中 使 用 的 变量 中 。 下 列 示例 将 翻 
译 后 的 文本 存储 于 greeting 变量 中 : 


{% trans "Hello!" as greeting %} 
<hl>{{ greeting }}</hl> 


{% trans %} 对 于 简单 的 翻译 字符 串 十 分 有 用 ， 但 却 无 法 处 理 包含 变量 的 翻译 内 容 。 

2. {% blocktrans %} 模 板 标签 

{% blocktrans %} 模板 标签 可 标记 包含 文字 和 变量 《使 用 占 位 符 ) 的 内 容 。 下 列 示例 
展示 了 如 何 使 用 {% blocktrans %} 标 签 ， 其 中 ， 翻 译 内 容 中 包含 了 一 个 name 变量 。 

{ 当 blocktrans gs}Hello {{ name }}!{% endblocktrans %} 

另外 ， 还 可 使 用 with 包含 模板 表达 式 ， 如 访问 对 象 属性 ， 或 者 针对 变量 使 用 模板 过 
滤器 。 通 常 ， 还 需要 对 此 使 用 占 位 符 。blocktrans 块 中 无 法 访问 表达 式 或 者 对 象 属性 。 下 
列 示例 显示 了 如 何 利用 with 针对 所 用 的 capfirst 过 滤器 包含 一 个 对 象 属性 。 


{$$ blocktrans with name=user.name|capfirst 当 } 
Hello {{ name }}! 
{$$ endblocktrans %} 
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全 注意 


当 需 要 在 翻译 字符 串 中 包含 变量 内 容 时 , 可 使 用 {% blocktrans 9%}, 而 非 {o% trans %}。 


3. 翻译 在 线 商 店 模板 
编辑 shop 应 用 程序 的 shop/base.html 模板 ， 确 保 在 模板 开始 处 加 载 了 il8n 标签 ， 以 
标记 翻译 字符 串 ， 如 下 所 示 : 


{% load il8n %} 
{%$ load static %} 
<!DOCTYPE html> 
<html> 
<head> 
<meta charset="utf-8" /> 
<title> 
{%s block title %}{% trans "My shop" %}{% endblock %} 
</title> 
<link href="{% static "css/base.css" %}" rel="stylesheet"> 
</head> 
<body> 
<div id="header"> 
<a href="/" class="1ogo">{fg trans "My shop" %}</a> 
</div> 
<div id="subheader"> 
<div class="cart"> 
{% with total items=cart|length %} 
{g% if cart|llength > 0 %} 
{% trans "Your cart" %}: 
<a href="{% url "cart:cart detail" %}"> 
{% blocktrans with total items plural=total items|pluralize 
total price=cart.get total price %} 
{{ total items }} item{{ total items plural }}, 
${{ total price }} 
{% endblocktrans %} 
</a> 
{S$ else $} 
{% trans "Your cart is empty." %} 
{% endif %} 
{SS endwith %®} 
</div> 
</div> 
<div id="content"> 
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{Ss block content $} 
{$$ endblock %} 
</div> 
</body> 
</html> 


此 处 须 注意 显示 购物 车 概要 内 容 的 {% blocktrans %} 标 签 。 相 应 地 ， 购 物 车 中 的 概要 
内 容 如 下 所 示 : 


{{ total items }} item{{ total items|lpluralize }}, 
${{ cart.get total price }} 


我 们 使 用 了 {% blocktrans with … %} 针 对 total itemslpluralize〈 此 处 所 用 的 模板 标签 ) 
和 cart.get total price〈 此 处 的 调用 方法 ) 设置 占 位 符 ， 最 终生 成 如 下 结果 : 


{% blocktrans with total items plural=total items|pluralize 
total price=cart.get total price %} 
{{ total items }} item{{ total items plural }}, 


${{ total price }} 
{% endblocktrans %} 


接 下 来 ， 编 辑 shop 应 用 程序 的 shop/product/detail.html 模板 ， 并 在 开始 处 加 载 il8n， 
且 位 于 {% extends %} 标 签 之 后 (该 标签 通常 是 模板 中 的 第 一 个 标签 )， 如 下 所 示 : 

{% load il8n %} 

接 下 来 ， 考 察 下 列 代码 行 : 

<input type="submit" value="Add to cart"> 

并 将 其 替换 为 : 

<input type="submit" value="{% trans "Rdd to cart" %}"> 

下 面 翻译 orders 应 用 程序 模板 。 对 此 , 编辑 orders 应 用 程序 的 orders/order/create.html 
模板 ， 并 标记 翻译 文本 ， 如 下 所 示 : 


{$$ extends "shop/base.html" %} 
{% load il8n %} 


{Ss block title %} 
{% trans "Checkout" %} 
{$$ endblock $} 


{ 当 block content $%} 
<hl>{% trans "Checkout" %}</hl> 
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<div class="order-info"> 
<h3>{% trans "Your order" %}</h3> 
<ul> 
{$$ for item in cart $} 
<1i> 
{{ item.quantity }}x {{ item.product.name }} 
<span>${{ item.total price }}</span> 
> 
{s endfor %} 
{% if cart.coupon %} 
<1i> 
{% blocktrans with code=cart.coupon.code 
discount=cart.coupon.discount %} 
"ff code }}" ({{ discount }}% off) 
{% endblocktrans %} 
<span>- ${{ cart.get discount|floatformat:"2" }}</span> 
</1i> 
{S$ endif %} 
</ul> 
<p>{% trans "Total" %}: ${{ 
cart.get total price after discount|floatformat:"2" }}</p> 
</div> 


<form action="." method="post" class="order-form"> 


{{ form.as p }} 
<p><input type="submit" value="{% trans "Place order" %}"></p> 


{% csrf token %} 

</form> 
{$$ endblock $} 
考察 本 章 示例 代码 中 的 下 列 文件 ， 以 查看 字符 串 相对 于 翻译 间 的 标记 方式 。 
口 ”shop 应 用 程序 ，shop/product/list.html 模板 。 
口 orders 应 用 程序 : orders/order/created.html 模板 。 
口 cart 应 用 程序 : cart/detail.html 模板 。 
下 面 更 新 消息 文件 ， 以 包含 新 的 翻译 字符 串 。 打 开 Shell 并 运行 下 列 命令 : 


django-admin makemessages --all 


.po 文件 位 于 myshop 项 目的 locale 目录 中 。 当 前 , orders 应 月 
翻译 所 标记 的 字符 串 
编辑 项 目 和 orders 应 用 程序 的 .po 翻译 文件 ， 并 在 msgstr 中 包含 西班牙 语 翻译 内 容 。 


程序 包含 了 所 有 的 针对 


者 
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另外 ， 还 可 使 用 本 章 示例 源 代码 中 已 经 翻译 完毕 的 .po 文件 。 
运行 下 列 命令 并 编译 翻译 文件 : 
django-admin compilemessages 
对 应 输出 结果 如 下 所 示 : 


Processing file django.po in myshop/locale/en/LC MESSAGES 
Processing file django.po in myshop/locale/es/LC MESSAGES 
Processing file django.po in myshop/orders/locale/en/LC MESSAGES 
Processing file django.po in myshop/orders/locale/es/LC MESSAGES 


对 于 每 个 .po 翻译 文件 ， 此 处 已 经 生成 了 .mo 文件 〈 其 中 包含 了 编译 后 的 翻译 内 容 ) 。 


9.2.5 ”使 用 Rosetta 


Rosetta 是 一 个 第 三 方 应 用 程序 , 可 使 用 与 Django 管理 站 点 相同 的 接口 对 翻译 内 容 进 
行 编辑 。Rosetta 可 方便 地 编辑 .po 文件 ， 并 更 新 编译 后 的 翻译 文件 。 下 面向 当前 项 目 中 加 
入 Rosetta。 

通过 下 列 命令 和 pip 安装 Rosetta: 

Pip install django-rosetta==0.8.1 

随后 , 在 项 目的 settings.py 文件 中 , 向 INSTALLED_APPS 设置 添加 rosetta'， 如 下 所 示 ; 


INSTALLED APPS = [ 

二 
'rosetta', 

] 

我 们 需要 向 主 URL 配置 中 添加 Rosetta 的 URL。 对 此 ， 编 辑 项 目的 urls.py 主 文件 ， 
并 向 其 中 添加 下 列 URL 路 径 : 

urlpatterns = [ 

a 

path('rosetta/', include('rosetta.urls')), 
path('', include('shop.urls', namespace='shop')), 


] 
这 里 ， 应 确保 将 上 述 内 容 置 于 shop.urls 路 径 之 前 ， 以 避免 产生 错误 的 路 径 匹 配 。 
打开 http://127.0.0.1:8000/admin/， 并 以 超级 用 户 身 份 登录 。 随 后 ， 在 浏览 器 中 访问 

http://127.0.0.1:8000/rosetta/。 在 Filter 菜单 中 ， 单 击 THIRD PARTY 并 显示 所 有 的 有 效 消 

息 文件 ， 同 时 包含 orders 应 用 程序 中 的 文件 。 图 9.5 显示 了 现 有 的 语言 列表 。 
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Home , Language selection 


APPLICATION PROGRESS MESSAGES TRANSLATED FUZzY 08SOLETE ALE 


Myshop 12 0 0 0 /Users/zenwdbe/myshop/locale/e/LC_MESSAGES/django.po 


Orders 0 0 /Users/zenWdbe/myshop/orders/locale/en/LC_MESSAGES/django.po 


APPUCATION PROGRESS MESSAGES TRANSLATED 。 FUZZY OBSOLETE FE 


Myshop /Users/zenx/dbe/myshop/locale/es/LC_MESSAGES/django.po 
Orders /Users/zenx/dbe/myshop/orders/Iocale/es/LC_MESSAGES/django.po 


Rosetta /Users/zenx/eny/dbe3/lib/python3.6/site- 
packages/rosetta/locale/es/LC_MESSAGES/django.po 


9.5 


单 击 Spanish 部 分 中 的 Myshop 链接 ， 并 编辑 西班牙 语 的 翻译 内 容 。 图 9.6 显示 了 翻 
译 字符 串 列 表 。 


Translate nto Spanish vor OE CD CD《9 


Q 


ORIGINAL SPANISH FUZZY OCCURRENCES(S) 


Quantity cart/forms.py:12 


Cantidad 


Coupon coupons/forms.py:6 


Cupon 


English myshop/settings.py:117 


Inglés 


Spanish Espafiol myshop/settings.py:118 


My shop shop/templates/shop/base.html:7 


Mitienda shop/templates/shop/base.html:12 


Your cart shop/templates/shop/base.html :18 


图 9.6 
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户 可 在 Spanish 列 中 输入 翻译 内 容 。OCCURRENCES(S) 列 显示 了 每 个 翻译 字符 
所 处 的 当前 文件 和 代码 行 。 
图 9.7 显示 了 包含 了 占 位 符 的 翻译 内 容 。 


过 


shop/templates/shop/base.html:20 


XCtotal_items)s item% %(total_items)s producto% 


(total_items_plural)s, (total items_plural)s, 
S$S%Ctotal_price)s S$%(total_price)s 


图 9.7 

Rosetta 使 用 了 不 同 的 背景 颜色 显示 占 位 符 。 当 对 相关 内 容 进行 翻译 时 ， 应 确保 占 位 
符 未 被 翻译 。 例 如 ， 考 察 下 列 字 符 串 : 

S(total items)s items (total items _plural)s，$s(total_price)s 

该 字符 串 将 被 翻译 为 西班牙 语 ， 如 下 所 示 : 

% (total_items)s productos (total items plural)s, $%(total price)s 

读者 还 可 查看 本 章 示 例 代 码 ， 并 针对 自己 的 项 目 使 用 同一 西班牙 语 翻译 。 

当 完成 了 翻译 内 容 的 编辑 工作 后 ， 单 击 Save and translate next block 按钮 ， 将 翻译 结 
果 保 存 至 .po 文件 中 。 当 对 翻译 内 容 进行 保存 时 ，Rosetta 将 编译 消息 文件 ， 因 而 无 须 运行 
compilemessages 命令 。 然 而 ，Rosetta 需要 对 locale 目录 执行 写 访问 操作 ， 进 而 写 入 消息 
文件 。 此 时 应 确保 该 目录 具备 有 效 的 权限 。 

如 果 希 望 其 他 用 户 能 够 对 翻译 内 容 进行 编辑 , 可 在 浏览 器 中 打开 http:/127.0.0.1:8000/ 
admin/auth/group/add/， 并 创建 名 为 translators 的 分 组 。 随 后 访问 http://127.0.0.1:8000/admin/ 
auth/user/， 并 对 授权 用 户 进行 编辑 ， 进 而 可 对 翻译 内 容 加 以 编辑 。 当 编辑 某 个 用 户 时 ， 
在 Permissions 部 分 ， 可 针对 每 个 用 户 向 Chosen Groups 添加 translators 分 组 。Rosetta 仅 
适用 于 超级 用 户 或 者 隶属 于 translators 分 组 中 的 用 户 。 

读者 可 访问 https://django-rosetta.readthedocs.io/n/latest/ 以 查看 Rosetta 文档 。 

Di 

当 向 产品 环境 中 加 入 新 的 翻译 内 容 时 ,如 果 使 用 真正 的 Web 服务 器 为 Django 提供 
服务 ,那么 在 运行 compilemessages 命令 之 后 , 或 者 保存 了 Rosetta 翻译 结果 后 ,必须 重 
新 加 载 服务 器 方 可 生效 。 


9.2.6 ”模糊 翻译 


读者 可 能 已 经 注意 到 ，Rosetta 中 包含 了 一 个 FUZZY 列 ， 该 列 并 不 是 Rosetta 中 的 特 
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性 ， 而 是 由 gettext 所 提供 。 如 果 名 zzy 标记 处 于 活动 状态 ， 那 么 ， 将 不 会 被 包含 至 编译 
后 的 消息 文件 中 。 该 标记 设置 了 供 翻译 者 查看 的 翻译 字符 串 。 当 利用 新 的 翻译 字符 串 更 
新 .po 文件 时 ， 某 些 翻译 字符 串 将 会 自动 标记 为 包 zzy。 当 gettext 发 现 某 些 msgid 稍 作 修 
改 时 ， 即 会 出 现 这 种 情况 。gettext 将 其 与 原 翻译 内 容 进 行 配 对 ， 并 将 其 标记 为 包 zzy 以 供 
审阅 。 翻 译 者 随后 将 对 模糊 翻译 进行 审阅 、 移 除 包 zzy 标记 并 再 次 编译 翻译 文件 。 


9.2.7 ”国际 化 操作 的 URL 路 径 


Django 针对 URL 提供 了 国际 化 功能 ， 并 包含 了 以 下 两 项 主要 特性 。 

口 URL 路 径 中 的 语言 前 级 : 向 URL 添加 语言 前 级 ， 以 在 不 同 的 基 URL 下 为 每 种 

语言 版 本 提供 服务 。 

口 ”翻译 后 的 URL 路 径 : 翻译 URL 路 径 ， 以 使 每 种 语言 的 URL 均 有 所 不 同 。 

翻译 URL 的 一 个 原因 是 为 了 优化 网 站 的 搜索 引擎 。 通 过 向 路 径 中 添加 语言 前 级 ， 将 
能 够 为 每 种 语言 建立 URL 索引 ， 而 不 是 为 所 有 语言 建立 单个 URL。 进 一 步 讲 ， 通 过 将 
URL 翻译 为 每 种 语言 ， 可 向 搜索 引擎 提供 针对 各 种 语言 排名 靠 前 的 URL。 

.向 URL 路 径 中 添加 语言 前 组 

Django 可 向 URL 路 径 中 加 入 语言 前 缀 。 例 如 ， 可 在 以 /en/ 开 始 的 路 径 下 向 站 点 提供 
英文 版 本 ， 而 /es/ 则 提供 西班牙 语 版 本 。 

当 使 用 URL 路 径 中 的 语言 时 ， 需 要 使 用 到 Django 提供 的 
LocaleMiddlewareMIDDLEWARE。 该 框架 以 此 识别 请 求 URL 中 的 当前 语言 。 之 前 ， 我 
们 曾 将 其 添加 至 项 目的 设置 中 ， 因 而 当前 无 须 执行 该 项 操作 。 

下 面向 URL 路 径 中 添加 语言 前 绥 。 对 此 , 编辑 myshop 应 用 程序 中 的 urls.py 主 文件 ， 
并 向 其 添加 讶 8n_patterms0， 如 下 所 示 : 


from django .conf.urls.il8n import il8n patterns 


urlpatterns = il8n Patterns( 
path('admin/', admin.site.urls), 
path('cart/', include('cart.urls', namespace='cart')), 
path('orders/', include('orders.urls', namespace='orders')), 
path('payment/', include('payment.urls', namespace='payment')), 
path('coupons/', include('coupons.urls', namespace='coupons')), 
path('rosetta/', include('rosetta.urls')), 
path('', include('shop.urls', namespace="'shop')), 

) 


我 们 可 对 不 可 翻译 的 标准 URL 和 i18n_patterns 下 的 路 径 进 行 组 合 ， 以 使 某 些 路 径 包 
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含 语言 前 其 他 路 径 则 不 包含 前 缀 。 然 而 ， 较 好 的 方法 是 仅 使 用 翻译 后 的 URL， 以 
aa URL 与 未 翻译 的 URL 路 径 进行 匹配 。 

运行 开发 服务 器 并 在 浏览 器 中 打开 http://127.0.0.1:8000/。Django 将 执行 之 前 描述 的 
相关 步骤 以 确定 当前 语言 ， 并 将 用 户 重 定向 至 对 应 的 请 求 路 径 ， 包 括 语言 前 级 。 查 看 浏 
览 器 中 的 URL, 当前 该 URL 应 为 http://127.0.0.1:8000/en/。 当 前 语言 通过 浏览 器 的 Accept- 
Language eon (英语 或 西班牙 语 ) ; 否则 将 使 用 设置 中 所 定义 的 默认 LANGUAGE_ 
CODE (英语 ) 。 

2. 翻译 URL 路 径 

Django 支持 URL 路 径 中 经 翻译 后 的 字符 串 。 对 于 单一 URL 路 径 ， 可 针对 每 种 语言 
使 用 不 同 的 翻译 。 我 们 可 以 使 用 ugettext lazy0 函 数 ， 以 及 与 文字 一 样 的 方式 标记 URL 
翻译 路 径 。 

编辑 myshop 项 上 的 urls.py 文件 ， 针 对 cart、orders、payment 和 coupons 应 用 程序 ， 
向 URL 路 径 的 正则 表达 式 中 添加 翻译 字符 串 ， 如 下 所 示 : 


from django.utils.translation import gettext lazy as _ 


urlpatterns = il8n patterns ( 
path(_('admin/'), admin.site.urls), 
paeht cart/'), include('cart.urls', namespace='cart')), 
path(_(" orders/'), include('orders.urls', namespace='orders')), 
path(_('payment/'), include('payment.urls', namespace='payment')), 
path( A” coupons/'), include('coupons.urls', namespace='coupons')), 
path('rosetta/', include('rosetta.urls')), 
path('', include('shop.urls', namespace='shop')), 


) 
编辑 orders 应 用 程序 的 urls.py 文件 ， 并 标记 URL 翻译 路 径 ， 如 下 所 示 : 


from django.utils.translation import gettext lazy as _ 


urlpatterns = [ 
path(_( 'create/'), views -Order create, name='order create'), 
本 

] 


编辑 payment 应 用 程序 的 urls.py 文件 ， 并 通过 下 列 方式 修改 代码 : 


from django.utils.translation import gettext lazy as _ 


urlpatterns = [ 
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path(_('process/'), views.payment process, name='process'), 
Pathe (” done/'), views -Payment done, name='done'), 
path(_(" canceled/'), views -payment canceled, name='canceled'), 
] 
此 处 并 不 需要 翻译 shop 应 用 程序 的 URL 路 径 ， 因 而 该 路 径 利 用 变量 构建 ， 且 不 包 
含 任何 其 他 文字 。 
打开 Shell， 并 运行 下 列 命令 更 新 包含 新 翻译 内 容 的 消息 文件 : 


django-admin makemessages --all 


确保 开发 服务 器 处 于 运行 状态 。 在 浏览 器 中 打开 http://127.0.0.1:8000/en/rosetta/， 单 
击 Spanish 下 的 Myshop 链接 。 此 时 将 会 显示 针对 翻译 的 URL 链接 。 此 外 ， 还 可 单 击 
Untranslated only 链接 ， 从 而 仅 查 看 尚未 翻译 的 字符 串 。 


9.2.8 切换 语言 


鉴于 我 们 采用 了 包含 多 种 语言 的 服务 内 容 ， 因 此 ， 用 户 应 可 对 站 点 中 的 语言 进行 切 
换 。 对 此 ， 将 向 当前 站 点 中 添加 一 个 语言 选择 器 。 其 中 ， 语 言 选 择 器 由 一 个 语言 列表 构 
成 ， 并 通过 链接 予以 显示 。 

编辑 shop 应 用 程序 的 shop/base.html 模板 ， 并 查看 下 列 代 码 行 : 


<div id="header"> 
<a href="/" class="logo">{% trans "My shop" %$}</a> 
</div> 


并 利用 下 列 代码 进行 蔡 换 : 


<div id="header"> 
<a href="/" class="logo">{% trans "My shop" %}</a> 


{% get current language as LANGUAGE CODE %} 
{% get available languages as LANGUAGES %} 
{% get language info list for LANGUAGES as languages %} 
<div class="languages"> 
<p>{% trans "Language" %}:</p> 
<ul class="languages"> 
{% for language in languages %} 
<1i> 
<a href="/{{ language.code }}/" 
{% if language.code == LANGUAGE CODE %} class="selected"{% endif%}> 
{{ language.name local }} 
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</a> 
cis 
{% endfor %} 
</ul> 
</div> 
</div> 
上 述 代 码 显示 了 语言 选择 器 的 构建 方式 ， 如 下 所 示 : 
(1) 首先 利用 {% load il8n %} 加 载 国 际 化 标签 。 
(2) 使 用 {% get_current language %} 标 签 检 索 当 前 语言 。 
(3) 利用 {% get available languages %} 模 板 标签 获取 定义 于 LANGUAGES 设置 中 
的 当前 语言 。 
(4) 通过 {% get_language_info_list %} 标 签 ， 可 方便 地 访问 语言 属性 。 
(5) 构建 HTML 列表 以 显示 所 有 的 语言 ， 并 向 当前 语言 添加 一 个 selected 类 属性 。 
根据 项 目 设置 中 的 有 效 语言 ， 我 们 使 用 了 il8n 提供 的 模板 标签 。 在 浏览 器 中 打开 
http://127.0.0.1:8000/， 此 时 ， 站 点 右上 方 显 示 了 相应 的 语言 选择 器 ， 如 图 9.8 所 示 。 


Mitienda Language: Engllsh Espaiiol 


Tu carro esta vacio. 


Productos 


Categorias 


Fos 


一 
Green tea Tea powder 


$30 | S21,2 


图 9.8 
户 即 可 方便 地 对 所 选 语言 进行 切换 。 


随后 ， 
9.2.9 利用 django-parler 翻译 模块 


Django 并 未 提供 翻译 模块 的 解决 方案 ， 我 们 需要 实现 自己 的 方法 ， 并 对 存储 于 不 同 
语言 中 的 内 容 加 以 管理 ， 或 者 使 用 第 三 方 模块 处 理 模块 翻译 问题 。 对 此 ， 存 在 多 种 第 三 
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方 应 用 程序 可 翻译 模块 字段 ， 分 别 采 用 不 同 的 方法 存储 和 访问 翻译 内 容 。django-parler 
便 是 其 中 之 一 ， 该 模块 提供 了 一 种 高 效 方式 对 模块 进行 翻译 ， 并 实现 了 与 Django 站 点 间 
的 无 颖 衔接 。 
django-parler 针对 包含 翻译 内 容 的 每 个 模块 均 生 成 了 独立 的 数据 库 表 , 该 表 包含 了 所 
有 的 翻译 字段 ， 以 及 翻译 内 容 所 属 原始 对 象 的 外 键 。 除 此 之 外 ，django-parler 还 包含 了 一 
个 语言 字段 ， 其 中 ， 每 行 针对 一 种 语言 存储 了 相关 内 容 。 

1. 安装 django-parler 

可 通过 下 列 命令 以 及 pip 安装 django-parler， 如 下 所 示 : 


Pip install django-parler==1.9.2 


编辑 项 目的 settings.py 文件 , 并 向 INSTALLED_APPS 设置 中 添加 'parler', 如 下 所 示 : 
INSTALLED APPS = [ 
用 
'parler', 
] 
此 外 ， 还 需要 向 设置 中 添加 下 列 内 容 : 


PARLER LANGUAGES = { 


None: ( 
{code”:” "en'}sy 
{ecole "os"]s 
), 
"default': { 


"fallback': 'en', 
"hide untranslated': False, 


} 

上 述 针 对 django-parler 设置 定义 了 en 和 es 两 种 语言 。 这 里 ,将 en 指定 为 默认 语言 ， 
同时 表明 django-parler 不 应 隐藏 未 翻译 的 内 容 。 

2. 翻译 模型 字段 

下 面 针 对 商品 目录 添加 翻译 行为 。django-parler 提供 了 一 个 TranslatedModel 模型 类 ， 


以 及 一 个 TranslatedFields 封装 器 翻译 模型 字段 。 编 辑 shop 应 用 程序 的 models.py 文件 ， 
并 添加 下 列 导 入 语句 : 


from parler.models import TranslatableModel, TranslatedFields 
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随后 ， 调 整 Category 目录 ， 并 使 name 和 slug 字段 可 被 翻译 ， 如 下 所 示 : 


class Category (TranslatableModel): 
translations = TranslatedFields( 
name = models.CharField (max length=200, 
db index=True), 
slug = models.SlugField (max length=200, 
db index=True, 
unique=True) 
) 


当前 ，Category 模型 继承 自 TranslatedModel, 而 非 models.Model。 另外 , name 和 slug 
字段 均 包 含 于 TranslatedFields 封装 器 中 。 
编辑 Product 模型 ， 并 针对 name、slug 和 description 字段 添加 翻译 行为 ， 如 下 所 示 : 


class Product (TranslatableModel): 

translations = TranslatedFields( 
name = models.CharField (max length=200, db index=True), 
slug = models.SlugField (max length=200, db index=True), 
description = models.TextField (blank=True) 

) 

category = models.ForeignKey (Category, 

related name='products') 
image = models.ImageField (upload to='products/%Y/sm/%d', 
blank=True) 

price = models.DecimalField (max digits=10, decimal places=2) 

available = models.BooleanField (default=True) 

created = models.DateTimeField (auto now add=True) 

updated = models.DateTimeField(auto now=True) 


针对 每 个 可 翻译 模块 生成 另 一 个 模块 ，django-parler 据 此 管理 翻译 结果 。 图 9.9 显示 
了 Product 模型 字段 ， 以 及 生成 后 的 ProductTranslation 模型 。 


id ProductTranslation 


category > 
image a 

price 2 
description 
1aguage_code 
master 


available 
created 
updated 
translations 


图 9.9 
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django-parler 生成 的 ProductTranslation 模型 包含 了 name、slug、description 翻译 字段 、 
language_code 字段 以 及 针对 Product 主 对 象 的 ForeignKey。 此 处 ，Product 与 ProductTranslation 
之 间 包 含 了 一 对 多 关系 。 针 对 Product 对 象 的 每 种 语言 ,分 别 存在 相应 的 ProductTranslation 
对 象 。 
由 于 Django 针对 翻译 内 容 使 用 了 单独 的 表 ， 因 而 无 法 使 用 Django 中 的 某 些 特性 。 
例如 ， 无 法 使 用 默认 的 、 基 于 翻译 字段 的 排序 功能 。 我 们 可 以 通过 查询 中 的 翻译 字段 执 
行 过 滤 操 作 ， 但 无 法 在 ordering Meta 选项 中 包含 可 翻译 的 字段 。 
编辑 shop 应 用 程序 的 models.py 文件 ， 并 注释 掉 Category Meta 类 的 ordering 属性 ， 
如 下 所 示 : 
class Category (TranslatableModel) : 
ee Meta: 
# ordering = ('name',) 
Verbose name = "category'" 
Verbose name plural = 'categories' 


除 此 之 外 ， 还 需要 注释 掉 Product Meta 类 的 ordering 和 index_together 属性 。 
django-parler 的 当前 版 本 并 未 对 index_together 的 验证 提供 任何 支持 ,同时 ,注释 掉 Product 
Meta 类 ， 如 下 所 示 : 

class Product (TranslatableModel) : 

ee 


# class Meta: 
# ordering = ('-name',) 
# index together = (('id', 'slug'),) 
关于 django-parler 模块 与 Django 之 间 的 兼容 性 ， 读 者 可 访问 https://django-parler. 
readthedocs.io/en/latest/compatibility.html 以 了 解 更 多 内 容 。 
3. 在 站 点 中 集成 翻译 功能 
django-parler 与 Django 管理 站 点 间 实 现 了 无 颖 整合 ,其 中 包含 了 TranslatableAdmin， 
并 重 载 了 Django 提供 的 ModelAdmin 类 ， 进 而 对 模块 翻译 加 以 管理 。 
编辑 shop 应 用 程序 的 admin.py 文件 ， 并 向 其 中 添加 下 列 导入 语句 : 


from parler.admin import TranslatableAdmin 


调整 CategoryAdmin 和 ProductAdmin 类 使 其 继承 自 TranslatableAdmin， 而 非 
ModelAdmin。django-parler 并 不 支持 prepopulated_ fields 属性 ， 但 支持 get_prepopulated_ 
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fields() 方 法 ， 并 提供 了 相同 的 功能 。 下 面 据 此 进行 相应 的 修改 、 编 辑 admin py 文件 ， 如 
下 所 示 : 


from django.contrib import admin 


from .models import Category, Product 
from parler.admin import TranslatableAdmin 


Q@admin.register (Category) 
class CategoryAdmin (TranslatableAdmin): 
list display = ['name', 'slug'] 


def get prepopulated fields(self, request, obj=None): 
return {'slug': ('name',)} 


@admin.register (Product) 
class ProductAdmin (TranslatableAdmin): 
list display = ['name', 'slug', 'price', 
'available', 'created', 'updated'] 
list filter = ['available', 'created', 'updated'] 
list editable = ['price', 'available'] 


def get prepopulated fields(self, request, obj=None): 
return {'slug': ('name',)} 


当前 ， 站 点 将 与 新 的 翻译 模型 协同 工作 ， 同 时 还 需要 将 修改 后 的 模型 与 数据 库 同步 。 
4. 模型 翻译 的 迁移 

打开 Shell， 运 行 下 列 命令 并 针对 模型 迁移 创建 新 的 迁移 : 

python manage.py makemigrations shop --name "translations" 

对 应 输出 结果 如 下 所 示 : 


Migrations for 'shop': 

shop/migrations/0002 translations.py 
- Create model CategoryTranslation 
- Create model ProductTranslation 
- Change Meta options on category 
- Change Meta options on product 
- Remove field name from category 
- Remove field slug from category 
- Alter index together for product (0 constraint(s)) 
- Add field master to producttranslation 
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- Add field master to categorytranslation 
- Remove field description from product 
- Remove field name from product 
- Remove field slug from product 
- Alter unique together for producttranslation (1 constraint(s)) 
- Alter unique together for categorytranslation (1 constraint(s)) 
迁移 自动 包含 了 django-parler 动态 创建 的 CategoryTranslation 和 ProductTranslation 
模型 。 需 要 注意 的 是 ，giant 迁移 删除 了 模型 中 之 前 已 有 的 字段 ， 这 意味 着 我 们 将 失去 该 
数据 ， 同 时 需要 在 站 点 运行 后 再 次 设置 目录 和 商品 。 
运行 下 列 命令 并 使 用 迁移 : 


Python manage.py migrate shop 
对 应 输出 结果 如 下 所 示 : 
Applying shop.0002 translations... OK 


当前 ， 模 型 与 数据 库 处 于 同步 状态 。 

利用 python manage.py runserver 命令 运行 开发 服务 器 ， 在 浏览 器 中 打开 http://127.0.0.1: 
8000/en/admin/shop/category/。 其 中 可 以 看 到 ， 由 于 name 和 slug 字段 被 删除 ， 同 时 使 用 
了 django-parler 生成 的 可 翻译 模型 ， 因而 现 有 的 目录 失去 了 name 和 slug 字段 。 单 击 该 目 
录 并 对 其 进行 编辑 ， 我 们 将 会 看 到 Change category 页 面包 含 了 两 个 不 同 的 选项 卡 ， 分 别 
对 应 于 English 和 Spanish 翻译 ， 如 图 9.10 所 示 。 


Django ellieil WELCOME ADMIN. VIEW SITE/ CHANGE PASSWORD /LOG OUT 
Horme， Shop » Categories ,Tea 
Change category (English) 


Save and add another Save and continue editing 


图 9.10 


确保 针对 所 有 的 现 有 目录 填写 name 和 slug 字段 ,同时 对 此 添加 西班牙 语 翻译 并 单 击 
SAVE 按钮 。 另 外 ， 在 修改 选项 卡 之 前 还 应 确保 对 已 修改 内 容 进行 保存 ， 和 否则 ， 将 会 丢 
失 相关 内 容 。 

在 完成 了 现 有 目录 的 数据 填写 工作 后 ， 打 开 http://127.0.0.1:8000/en/admin/shop/product/， 
并 对 每 项 商品 进行 编辑 ， 包 括 英 语 和 西班牙 语 的 name、slug 和 description 。 

5. 添加 翻译 视图 

我 们 需要 借助 于 shop 视图 进而 使 用 翻译 QuerySet. 运 行 下 列 命令 并 打开 Python Shell: 

Python manage.py shell 


下 面 考察 如 何 检索 并 查询 翻译 字段 。 为 了 获得 具有 可 翻译 字段 的 对 象 ， 并 将 其 翻译 
为 特定 语言 ， 可 采用 Django 中 的 activate0) 函 数 ， 如 下 所 示 : 


>>> from shop.models import Product 

>>> from django.utils.translation import activate 
>>> activate('es') 

>>> product=Product .objects .first() 

>>> product .name 

'Té verde' 


另 一 种 方法 是 使 用 django-parler 提供 的 language0 管 理 器 ， 如 下 所 示 : 


>>> product=Product.objects.language('en') .first() 
>>> product .name 
'Green tea' 


当 访 问 翻译 字段 时 ， 字 段 可 通过 当前 语言 加 以 解析 。 对 于 某 一 对 象 ， 可 设置 不 同 的 
当前 语言 ， 以 访问 特定 的 翻译 内 容 ， 如 下 所 示 : 


>>> product.set current language('es') 
>>> product .name 


'Té verde' 

>>> product.get current language() 

‘es' 

当 利 用 filter0 执 行 菜 个 QuerySet 时 ， 可 采用 基于 translations 语法 的 关联 翻译 对 象 


进行 过 滤 ， 如 下 所 示 : 


>>> Product.objects.filter(translations name='Green tea') 


<TranslatableQuerySet [<Product: Té verde>]> 


下 面 尝试 使 用 商品 目录 视图 。 对 此 , 编辑 shop 应 用 程序 的 views.py 文件 , 在 product list 
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Ee 


Ph， 查 看 下 列 代码 行 : 


category = get object or 404(Category, slug=category slug) 


将 其 蔡 换 为 下 列 内 容 : 


language = request.LANGUAGE CODE 

category = get object or 404(Category, 
translations language code=language, 
translations slug=category_ slug) 


随后 ， 编 辑 product_detail 视图 并 查看 下 列 代码 行 : 
product = get object or 404(Product, 
id=id, 
slug=slug, 
available=True) 


视图 


I 


并 将 其 葵 换 为 下 列 代码 : 


language = request.LANGUAGE CODE 

product = get object or 404(Product, 
id=id, 
translations language code=language, 
translations slug=slug, 
available=True) 


当前 ，product_list 和 product_detail 视图 用 于 检索 对 象 〈 根 据 翻译 字段 ) 。 运 行 开发 
服务 器 并 在 浏览 器 中 打开 http:/127.0.0.1:8000/es/， 图 9.11 显示 了 商品 列表 页 面 ， 其 中 包 
含 了 翻译 为 西班牙 语 的 所 有 商品 。 
Mitienda Language: En 


Tu carro esta vacio. 


Productos 


Categorias 


一 


Té en polvo 


$21,2 


图 9.11 
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目前 , 每 种 商品 的 URL 采用 了 翻译 为 当前 语言 的 slug 字段 予以 构建 。 如 西班牙 语 的 
商品 URL 表示 为 http://127.0.0.1:8000/es/2/te-rojo/; 而 英语 的 URL 则 表示 为 http://127.0.0.1: 
8000/en/2/red-tea/。 当 浏览 商品 详细 页 面 时 ， 将 会 看 到 翻译 后 的 URL， 以 及 所 选 语言 对 应 
的 商品 内 容 ， 如 图 9.12 所 示 。 


Mitienda Language: English espariol 


Tu carro esta vacio. 


Té rojo 
Té 


$45,5 


El té pu-erh es conocido en Occidente también como té rojo (en chino: 普洱 
茶 , pinyin: pUercha) y su nombre proviene de la region de Pu'er de Yunnan 
China, de donde procede. Se trata de un té inusual en China, siendo este el 
mayor productor del té rojo o pu-erh del mundo, 


图 9.12 


关于 django-parler 的 更 多 内 容 ， 读 者 可 访问 https://django-parler.readthedocs.io/en/latest/ 
以 查看 完整 文档 。 

前 述 内 容 讨 论 了 如 何 翻 译 Python 代码 、 模 板 、URL 路 径 以 及 模型 字段 。 为 了 进一步 
完善 国际 化 和 本 地 化 处 理 ， 还 需要 针对 日 期 、 时 间 和 数字 使 用 本 地 化 格式 。 


9.2.10 ”本 地 化 格式 


取决 于 用 户 的 地 域 ， 可 能 需要 采取 不 同 的 格式 显示 日 期 、 时 间 和 数字 。 在 项 目的 
settings.py 文件 中 ， 通 过 将 USE_L10N 设置 修改 为 True， 可 激活 本 地 化 格式 。 
当 启 用 USE_L10N 且 Django 输出 模板 中 的 一 个 数值 时 , 将 尝试 使 用 特定 于 本 地 的 格 
式 。 不 难 发 现 ， 站 点 中 英语 版 本 的 小 数 使 用 了 小 数 点 分 隔 符 ， 而 西班牙 语 版 本 则 采用 了 
逗号 。 这 取决 于 Django 指定 的 es 本 地 格式 。 关 于 西班牙 语 的 格式 配置 ， 读 者 可 访问 
https://github.com/django/django/blob/stable/2.0.x/django/conf/locale/es/formats.py 了 解 相关 
内 容 。 

通常 情况 下 ，USE LION 设置 为 True，Django 针对 各 地 区 使 用 本 地 化 格式 。 然 而 ， 
在 某 些 场合 下 ， 可 能 不 需要 采用 本 地 化 数值 。 当 提供 机 器 可 读 格 式 的 JavaScript 或 JSON 
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时 ， 这 一 点 尤其 重要 。 

Django 提供 了 {% localize 9%} 模 板 标签 ， 并 可 针对 模板 片段 开启 /关闭 本 地 化 功能 ， 进 
而 可 对 本 地 化 格式 加 以 控制 。 对 此 ， 需 要 加 载 110n 标签 以 使 用 该 模板 标签 。 下 列 代码 显 
示 了 如 何在 模板 中 开启 /关闭 本 地 化 功能 。 


{$$ load ll0n %} 


{% localize on %} 
{{ value }} 
{$$ endlocalize %} 


{$$ localize off %} 
{{ value }} 
{g endlocalize %} 


除 此 之 外 ，Django 还 提供 了 localize 和 unlocalize 模板 过 滤器 ， 以 强制 或 禁用 某 个 值 
的 本 地 化 操作 。 此 类 过 滤器 的 使 用 方式 如 下 所 示 : 


{{ value|localize }} 
valuelunlocalize }} 


此 外 ， 还 可 创建 自 定义 格式 文件 ， 并 指定 本 地 格式 。 关 于 本 地 化 格式 的 详细 信息 ， 
读者 可 访问 https://docs.djangoproject.com/en/2.0/topics/il8n/formatting/。 


9.2.11 使 用 django-localflavor 验证 表单 字段 


django-localflavor 是 一 个 第 三 方 模块 ， 其 中 包含 了 特定 的 工具 集 ， 如 特定 于 每 个 国家 
的 表单 字段 或 模型 字段 。 这 对 于 验证 本 地 区 域 、 本 地 电话 号 码 、 信 用 卡号 码 、 社 会 安全 
号 码 等 十 分 有 用 。 该 数据 包 被 组 织 成 一 系列 以 ISO 3166 国家 代码 命名 的 模块 。 

使 用 下 列 命令 安装 django-localflavor: 


pip install django-localflavor==2.0 


编辑 项 目的 settings.py 文件 ， 并 向 INSTALLED APPS 设置 中 添加 localflavor， 如 下 
所 示 : 
INSTALLED APPS = [ 
te 


'localflavor', 
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下 面 将 添加 美国 的 邮政 编码 字段 ， 并 以 此 创建 新 订单 。 
编辑 orders 应 用 程序 的 forms.py 文件 ， 如 下 所 示 : 
from django import forms 


from .models import Order 
from localflavor.us.forms import USZipCodeField 


class OrderCreateForm (forms .ModelForm) : 
Postal_code = USZipCodeField() 
class Meta: 
model = Order 
fields = ['first name', 'last name', 'email', 'address', 
postal code, "ciEy"] 
此 处 从 localflavor 的 us 包 中 导入 了 USZipCodeField 字段 ， 并 将 其 用 于 OrderCreateForm 
表单 的 postal_ code 字段。 
运行 开发 服务 器 ， 并 在 浏览 器 中 打开 http://127.0.0.1:8000/en/orders/create/。 填 写 全 部 
字段 、 输 入 3 个 字母 的 邮政 代码 并 于 随后 提交 表单 。 此 时 将 会 显示 USZipCodeField 生成 
的 验证 错误 ， 如 下 所 示 : 


Enter a zip code in the format XXXXX or XXXXX-XXXX. 


这 仅 是 一 个 简单 的 示例 ， 展 示 了 如 何在 项 目 中 使 用 源 自 localflavor 中 的 自 定义 字段 ， 
以 实现 验证 功能 。localflavor 提供 的 本 地 组 件 使 得 应 用 程序 可 适应 于 特定 的 国家 。 读 者 可 
访问 https://django-localflavor.readthedocs.io/en/latest/， 以 查看 django-localflavor 文档 ， 以 
及 针对 每 个 国家 的 本 地 组 件 。 

下 面 将 讨论 构建 在 线 商 店 应 用 程序 的 推荐 引擎 。 


9.3 构建 推荐 引擎 


推荐 引擎 是 一 个 系统 ， 它 预测 用 户 对 某 件 商品 的 偏好 或 评级 。 系 统 根据 用 户 的 行为 
和 信息 为 其 选择 相关 的 商品 。 当 前 ， 推 荐 系统 在 许多 在 线 商店 应 用 程序 中 均 有 所 应 用 ， 
并 帮助 用 户 从 大 量 的 商品 中 选择 感 兴趣 的 内 容 。 较 好 的 推荐 系统 可 提升 用 户 的 参与 度 。 
电子 商务 网 站 也 可 从 相关 产品 的 推荐 系统 中 获 益 ， 进 而 提高 平均 销售 额 。 

本 节 将 创建 一 个 简单 且 功能 强大 的 推荐 引擎 ， 进 而 向 用 户 推荐 常 购 商品 。 我 们 将 根 
据 历史 销售 记录 对 商品 予以 推荐 ， 进 而 判别 经 常 性 购买 的 商品 。 此 外 ， 还 将 推荐 两 种 不 
同 场合 下 的 “互补 性 ”商品 ， 如 下 所 示 。 
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口 ”商品 详细 页 面 : 我 们 将 显示 一 个 商品 列表 ， 通 常 与 当前 给 定 的 产品 一 起 购买 ， 
并 显示 为 : 购买 该 产品 的 用 户 也 购买 了 X、Y、Z。 这 里 需要 定义 一 个 数据 结构 ， 
以 存储 每 件 商品 与 所 显示 商品 一 起 购买 的 次 数 。 
口 ”购物 车 详细 页 面 : 根据 用 户 向 购物 车 中 加 入 的 商品 ， 还 可 推荐 与 其 一 起 购买 的 
商品 。 在 这 种 情况 下 ， 所 关联 的 商品 积分 值 须 进行 汇总 。 
这 里 将 使 用 到 Redis 存储 一 起 购买 的 商品 。 回 忆 一 下 ， 第 6 章 曾 对 Redis 有 所 讨论 ， 
如 果 读 者 尚未 安装 Redis， 可 参考 第 6 章 中 的 相关 内 容 。 
下 面 将 根据 添加 至 购物 车 中 的 商品 向 用 户 进行 商品 推荐 ， 并 针对 站 点 中 购买 的 每 件 
商品 在 Redis 中 存储 一 个 键 。 该 键 包含 了 基于 积分 值 的 Redus 有 序 集 。 每 次 购买 商品 完成 
后 ， 一 同 购买 的 每 件 商品 其 积分 值 将 加 1。 
在 订单 成 功 支付 后 ， 将 对 每 件 购买 的 商品 存储 一 个 键 ， 包 含 属于 同一 订单 的 商品 有 
序 集 。 该 有 序 集 可 生成 一 同 购买 的 商品 的 积分 值 。 
利用 下 列 命令 在 当前 环境 中 安装 redis-py: 
Pip install redis==2.10.6 


这 是 


编辑 项 目的 settings.py 文件 ， 并 向 其 中 添加 下 列 设置 : 
REDIS HOST = "localhost" 


REDIS PORT = 6379 
REDIS DB = 1 


上 述 设 置 需要 建立 与 Redis 间 的 连接 。 对 此 ， 在 shop 应 用 程序 中 创建 新 文件 ， 将 其 
命名 为 recommender.py， 并 向 其 中 添加 下 列 代码 : 
import redis 


from django.conf import settings 
from .models import Product 


# connect to redis 

r= redis.strictRedis (host=settings.REDIS HOST, 
port=settings.REDIS PORT, 
db=settings.REDIS DB) 


class Recommender (object): 


def get product key(self, id): 
return "product:{}:purchased with' .format (id) 


def products bought (self, products): 
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product ids = [p.id for p in products] 
for product id in product ids: 
for with id in product ids: 
# get the other products bought with each product 
if product id != with id: 
# increment score for product purchased together 
r.zincrby(self.get product key (product id)， 
with id， 
amount=1) 

其 中 ，Recommender 类 可 存储 商品 并 对 其 生成 推荐 内 容 。get_product_key() 方 法 接收 
一 个 Product 对 象 ID, 并 针对 有 序 集 (其 中 存储 了 关联 商品 ) 构建 Redis 键 , 形 如 product: 
[id]j:purchased_with 。 

products_ bought() 方 法 接收 一 起 购 入 的 Product 对 象 列 表 〈 也 就 是 说 ， 隶 属于 同一 个 
订单 ) 。 在 该 方法 中 ， 将 执行 下 列 任务 : 

(1) 对 于 给 定 的 Product 对 象 获取 商品 人 D。 
(2) 遍历 商品 ID。 对 于 每 个 ID， 遍历 每 件 商品 并 忽略 同一 件 商品 ， 进 而 获得 一 起 
购买 的 商品 。 
(3) 针对 每 件 购买 的 商品 ， 利 用 get product id() 方 法 获得 Redis 商品 键 。 例 如 ， 对 
于 ID 为 33 的 商品 ， 该 方法 返回 键 product:33:purchased_with， 表 示 为 一 个 针对 有 序 集 的 
键 ， 包 含 了 与 当前 商品 一 同 购买 的 商品 ID。 
(4) 将 包含 于 有 序 集中 的 每 个 商品 DD 的 积分 值 增加 1。 该 积分 值 表 示 与 当前 商品 一 
起 购买 的 、 另 一 件 商品 的 购买 次 数 。 
因此 ， 我 们 定义 了 一 个 方法 ， 用 于 存储 一 起 购买 的 商品 ， 并 设置 其 积分 值 。 相 应 地 ， 
3 一 个 方法 可 针对 给 定 商品 列表 检索 一 起 购买 的 商品 。 对 此 ， 可 将 suggest_products_for() 
方法 添加 至 Recommender 类 中 ， 如 下 所 示 : 
def suggest products forl(self, products, max results=6): 
product ids = [p.id for p in products] 
if len (Products) == 
# only 1 product 
suggestions = r.zrangel( 
self.get product key(product ids[0]), 
0, -1, desc=True) [:max results] 


else: 
# generate a temporary key 
fiat da = "olmtlste(idy for 40 in product tdsl) 
tmp key = 'tmp {}'.format (flat ids) 
# multiple products, combine scores of all products 
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# store the resulting sorted set in a temporary key 
keys = [self.get product key(id) for id in product ids] 


r.zunionstore (tmp key, keys) 


# remove ids for the products the recommendation is for 


r.zrem(tmp key, *product ids) 


# get the product ids by their score, descendant sort 


suggestions = r.zrange (tmp key, 0, -1, 


desc=True) [:max results] 


# remove the temporary key 
r.delete (tmp key) 


suggested products ids = [int(id) for id in suggestions] 


# get suggested products and sort by order of appearance 


suggested products = 


list(Product.objects.filter(id in=suggested products ids)) 


suggested products.sort (key=lambda x: 
suggested products ids.index(x.id)) 
return suggested products 


suggest_products_for() 方 法 接收 下 列 参 数 。 
口 “products: 表示 推荐 的 Product 对 象 列表 ， 可 包含 一 件 或 多 


件 商品 。 


口 “max results:; 定义 为 一 个 整数 ， 表 示 为 所 返回 的 最 大 推荐 数量 。 


在 该 方法 中 ， 将 执行 下 列 任务 : 
(1) 针对 给 定 的 Product 对 象 ， 获 得 商品 ID。 


(2) 对 于 一 件 商品 , 检索 与 其 一 起 购买 的 商品 ID, 并 通过 一 起 购买 的 次 数 进行 排序 。 
对 此 ,可 使 用 Redis 中 的 ZRANGE 命令 。 此 处 将 最 终 数 量 限制 在 max_results 属性 中 指定 


的 数量 (默认 时 为 6〉。 


(3) 对 于 多 件 商 品 ， 将 生成 一 个 采用 商品 ID 构建 的 临时 Redis 键 。 
(4) 对 于 每 件 给 定 商品 的 有 序 集中 的 全 部 项 ， 将 对 全 部 积分 值 汇总 求 和 ， 这 可 通过 


Redis 的 ZUNIONSTORE 命令 加 以 实现 。ZUNIONSTORE 命令 利 
并 集 , 并 将 元 素 的 积分 值 求 和 结果 存储 于 一 个 新 的 Redis 键 中 。 关 于 


该 命令 ， 读 者 可 访问 


https://redis.io/commands/ZUNIONSTORE 以 了 解 更 多 内 容 。 此 处 将 汇总 积分 结果 保存 于 


一 个 临时 键 中 。 


日 给 定 键 执行 有 序 集 的 


(5) 由 于 需要 汇总 积分 值 ， 因 而 可 能 获得 与 推荐 结果 相同 的 
ZREM 命令 从 生成 的 有 序 集中 进行 删除 。 


并 于 随后 移 除 临 时 键 。 


商品 。 对 此 ， 可 利用 


(6) 从 临时 键 中 检索 商品 ID， 并 将 结果 数量 限制 在 max_results 属性 中 指定 的 数量 ， 


(7) 最 后 ， 利 用 给 定 的 ID 获得 Product 对 象 ， 并 按照 与 它们 相同 的 顺序 对 商品 进行 
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出 于 操作 目的 , 还 需要 添加 一 个 方法 , 并 清空 推荐 内 容 。 相 应 地 ,可 向 Recommender 
类 添加 下 列 方法 : 


def clear purchases (self): 
for id in Product.objects.values list('id', flat=True): 
r.delete(self.get product key (id)) 


在 使 用 推荐 引擎 的 过 程 中 ， 确 保 在 数据 库 中 包含 多 个 Product 对 象 ， 并 在 Redis 路 径 
的 Shell 中 运行 下 列 命令 初始 化 Redis 服务 器 : 
src/redis-server 


打开 另 一 个 Shell， 运 行 下 列 命 令 打 开 Python Shell: 


python manage.py shell 
确保 在 数据 库 中 至 少 包含 4 件 商品 ， 并 通过 其 名 称 检索 4 件 不 同 的 商品 : 


>>> from shop.models import Product 

>>> black tea = Product.objects.get(translations name='Black tea') 
>>> red tea = Product.objects.get(translations name='Red tea') 

>>> green tea = Product.objects.get(translations name='Green tea') 
>>> tea powder = Product.objects.get(translations name='Tea powder') 


随后 ， 尝 试 添加 某 些 商 品 ， 并 对 推荐 引擎 进行 测试 ， 如 下 所 示 : 


>>> from shop.recommender import Recommender 


>>> r = Recommender () 

>>> r.products bought([black tea, red teal]) 

>>> r.products bought([black tea, green teal]) 

>>> r.products bought([red tea, black tea, tea powder]) 
>>> r.products bought([green tea, tea powder]) 

>>> r.products bought([black tea, tea powder]) 

>>> r.products bought([red tea, green teal]) 


另外 ， 所 存储 的 积分 值 如 下 所 示 : 


black tea: red tea (2), tea powder (2), green tea (1) 
red tea: black tea (2), tea powder (1), green tea (1) 
green tea: black tea (1), tea powder (1), red tea(1) 
tea powder: black tea (2), red tea (1), green tea (1) 


下 面 激 活 一 种 语言 以 对 翻译 后 的 商品 进行 检索 ， 进 而 获得 商品 的 推荐 内 容 ， 并 与 给 
定 的 单 件 商品 一 同 购买 ， 如 下 所 示 : 


~ 
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>>> from django.utils.translation import activate 

>>> activate('en') 

>>> r.suggest products for ([black tea]) 

[<Product: Tea Powder>，<Product: Red tea>，<Product: Green tea>] 
>>> r.suggest products forl([red teal]l) 

[<Product: Black tea>, <Product: Tea powder>, <Product: Green tea>] 
>>> r.suggest products forl([green teal]l) 

[<Product: Black tea>, <Product: Tea powder>, <Product: Red tea>] 
>>> r.suggest products forl([tea powder]) 

[<Product: Black tea>, <Product: Red tea>, <Product: Green tea>] 


可 以 看 到 ， 推 荐 商品 的 顺序 源 自 其 积分 值 。 下 面 针 对 包含 汇总 积分 值 的 多 件 商品 获 
取 推荐 内 容 ， 如 下 所 示 : 


>>> r.suggest Products forl([black tea, red teal) 
[<Product: Tea powder>, <Product: Green tea>] 


>>> r.suggest products forl([green tea, red teal) 
[<Product: Black tea>, <Product: Tea powder>] 


>>> r.suggest products forl([tea powder, black teal]) 
[<Product: Red tea>, <Product: Green tea>] 


不 难 发 现 ， 所 建议 的 商品 与 汇总 积分 值 相 匹配 。 例 如， 针对 black_tea 和 red_tea 所 推 
荐 的 商品 分 别 是 tea_powder (2+1) 和 green tea (1+1)。 

经 验证 ， 推 荐 算法 以 期 望 的 方式 工作 。 下 面 针 对 当前 站 点 显示 推荐 商品 。 

编辑 shop 应 用 程序 的 views.py 文件 ,添加 推荐 功能 并 在 product_detail 视图 中 检索 4 
种 推荐 商品 的 最 大 值 ， 如 下 所 示 : 


from .recommender import Recommender 


def product detail (request, id, slug): 
language = request .LANGUAGE CODE 
product = get object or 404(Product, 
id=id, 
translations language code=language, 
translations slug=slug, 
available=True) 
CartAddProductForm() 


cart product form 


r= Recommender() 


recommended products = r.suggest products for([product], 4) 


return render(request, 
'shop/product/detail .html', 


第 9 章 扩展 在 线 商店 应 用 程序 “311。 


{'product': product, 
"cart product form': cart product form, 
'recommended products': recommended products}) 


编辑 shop 应 用 程序 的 shop/product/detail.html 模板 ， 并 在 {{ product.description | 
linebreaks }} 之 后 添加 下 列 代码 : 


{s if recommended products %} 
<div class="recommendations"> 
<h3>{% trans "People who bought this also bought" %}</h3> 
{$$ for p in recommended products %} 
<div class="item"> 
<a href="{{ p.get absolute url }}"> 
<img src="{% if p.image %}{{ p.image.url }}{% else %} 
{% static "img/no image.png" %}{% endif %}"> 
</a> 
<p><a href="{{ p.get absolute url }}">{{ p.name }}</a></p> 
</div> 
{$$ endfor $} 
</div> 
{% endif %} 


运行 开发 服务 器 ， 并 在 浏览 器 中 打开 http://127.0.0.1:8000/en/。 单 击 任意 一 件 商品 
看 其 详细 信息 。 可 以 看 到 ， 推 荐 商品 位 于 当前 商品 的 下 方 ， 如 图 9.13 所 示 。 


Tea powder 


Tea 


$21.2 


| 
People who bought this also bought 


Black tea Green tea 


图 9.13 
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除 此 之 外 ， 还 应 在 购物 车 中 包含 商品 推荐 内 容 。 相 关 推 荐 内 容 取 决 于 用 户 添加 至 购 
物 车 中 的 商品 。 编 辑 cart 应 用 程序 中 的 views.py 文件 ， 导 入 Recommender 类 并 编辑 
cart_detail 视图 ， 如 下 所 示 : 


from shop.recommender import Recommender 


def cart detail (request): 
cart = Cart (request) 
for item in cart: 
item['update quantity form'] = CartAddProductForm( 
initial={'quantity': item['quantity'], 
"update': True}) 


coupon apply form = CouponApplyForm() 
r= Recommender () 


Cart products = [item['Product'] for item in cart] 
recommended _ Products = r.suggest products forl(cart products, 
max_ results=4) 


return render (request, 
'cart/detail.html', 
eo 
"coupon apply form': coupon apply form, 
'recommended products': recommended products}) 


编辑 cart 应 用 程序 的 cart/detail.html 模板 , 并 在 </table> HTML 标签 


添加 下 列 代码; 
UE recommended products %} 
<div class="recommendations cart"> 
<h3>{% trans "People who bought this also bought" %}</h3> 
{% for p in recommended products %} 
<div class="item"> 
<a href="{{ p.get absolute url }}"> 
<img src="{% if p.image %}{{ p.image.url }}{% else %} 
{% static "img/no image.png" %}{% endif $}"> 
</a> 


<p><a href="{{ p.get absolute url }}">{{ p.name }}</a></p> 
</div> 
{$$ endfor %} 
</div> 
{SS endif %} 


在 浏览 器 中 打开 http://127.0.0.1:8000/en/， 并 向 购物 车 中 添加 一 组 商品 。 当 访问 
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http://127.0.0.1:8000/en/cart/ 时 ,针对 购物 车 中 的 该 项 商品 , 将 会 看 到 汇总 后 的 商品 推荐 内 
容 ， 如 图 9.14 所 示 。 


Your shopping cart 


Remove Unit price 


Remove 


1 renwe 


People who bought this also bought Apply a coupon: 


Coupon: Apply 
NO IMAC 
AMAILAB 


Blacktea Red tea 


图 9.14 


至 此 ， 我 们 通过 Django 和 Redis 构建 了 完整 的 推荐 引擎 。 


9.4 本 章 小 结 


本 章 通过 会 话机 制 创 建 了 一 个 优惠 券 系统 ， 我 们 还 学 习 了 国际 化 和 本 地 化 操作 的 工 
作 方式 。 此 外 ， 本 章 还 通过 Redis 构建 了 一 个 推荐 系统 。 

第 10 章 将 介绍 一 个 新 项 目 ， 并 通过 基于 类 的 视图 和 Django 搭建 一 个 网 络 教 学 平台 ， 
同时 还 将 创建 一 个 包含 定制 内 容 的 管理 平台 。 


第 10 章 ”打造 网 络 教学 平台 


第 9 章 向 在 线 商 店 应 用 程序 中 加 入 了 国际 化 机 制 ， 同 时 还 构建 一 个 优惠 券 系统 以 及 商 
品 推荐 引擎 , 本 章 将 创建 一 个 新 项 目 , 即 网 络 教学 平台 , 并 构建 一 个 内 容 管理 系统 CCMS ) 。 
章 主要 涉及 以 下 内 容 : 
口 ”为 模型 创建 固定 文件 。 
使 用 模型 继承 。 
创建 模型 自 定义 字段 。 
使 用 基于 类 的 视图 和 混入 类 。 
管理 分 组 和 权限 。 
创建 CMS 。 


OOOODO DO 


10.1 设置 网 络 教 学 项 目 


本 章 将 构建 一 个 灵活 的 CMS， 教 师 可 以 此 管理 课程 以 及 相关 内 容 。 
首先 ， 可 对 新 项 目 创 建 一 个 虚拟 环境 ， 并 利用 下 列 命令 对 其 激活 。 


mkdir env 
Virtualenv env/educa 
source env/educa/bin/activate 


利用 下 列 命令 在 虚拟 环境 中 安装 Django， 如 下 所 示 : 
pip install Django==2.0.5 

我 们 将 在 项 目 中 ， 因 此 需要 利用 下 列 命令 安装 Pillow: 
Pip install Pillow==5.1.0 

利用 下 列 命令 创建 新 项 目 : 

django-admin startproject educa 


在 新 的 educa 目录 中 ， 利 用 下 列 命令 创建 新 应 用 程序 : 


EE 


i 
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cd educa 
django-admin startapp courses 


编辑 educa 项 目的 settings.py 文件 , 并 向 INSTALLED_APPS 设置 中 添加 courses， 如 
下 所 示 : 


INSTALLED APPS = [ 

"courses .apps.CoursesConfig' ， 
"django .contrib.admin'， 
"django .contrib .auth'"'， 

"django .contrib .contenttypes'， 
"django .contrib.sessions'， 
"django .contrib.messages'， 
"django .contrib.staticfiles'， 


] 
courses 应 用 程序 针对 当前 项 目 处 于 活动 状态 ， 下 面 针 对 课程 和 课程 内 容 定义 模型 。 


10.2 ”构建 课程 模型 


网 络 教学 平台 将 提供 不 同 科 目的 课程 。 其 中 ， 每 门 课程 将 分 为 可 配置 数量 的 模块 ， 
每 个 模块 将 包含 可 配置 数量 的 内 容 。 这 里 将 包含 不 同类 型 的 内 容 ， 如 文本 、 文 件 、 图 像 
或 视频 。 下 列 示例 展示 了 课程 目录 的 数据 结构 : 


Subject 1 
Course 1 
Module 1 
Content 1 (image) 
Content 2 (text) 
Module 2 
Content 3 (text) 
Content 4 (file) 
Content 5 (video) 


接 下 来 构建 课程 模块 。 对 此 , 编辑 courses 应 用 程序 的 文件 ， 间 


from django.db import models 
from django.contrib.auth.models import User 


可 
- 
于 


添加 下 列 代码 : 


class Subject (models.Model): 
title = models.CharField (max length=200) 
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slug = models.SlugField (max length=200, unique=True) 


class Meta: 
ordering = ['title'] 


def str "(SelE)s 
return self.title 


class Course (models.Model): 
owner = models.ForeignKey (User, 
related name="'courses created', 
on delete=models .CASCADE) 
subject = models.ForeignKey (Subject, 
related name='courses', 
on delete=models .CASCADE) 
title = models.CharField (max length=200) 
slug = models.SlugField (max length=200, unique=True) 
Overview = models.TextField() 
created = models.DateTimeField(auto now add=True) 


class Meta: 
ordering = ['-created'] 


def str (self): 
return self.title 


class Module (models .Model): 
course = models.ForeignKey (Course, 
related name='modules'， 
on delete=models .CASCADE) 
title = models.CharField (max length=200) 
description = models.TextField (blank=True) 


def ster UsoLtys 
return self.title 
上 述 代 码 分 别 定义 了 初始 Subject、Course 和 Module 模块 。 其 中 ，Course 模型 字段 
如 下 所 示 。 
owner: 表示 课程 教师 。 
subject: 表示 课程 所 属 的 科目 ， 即 指向 Subject 模型 的 ForeignKey 字段 。 
title: 表示 课程 的 标题 。 
slug: 表示 课程 的 slug， 稍 后 将 用 于 URL 中 。 


DODDODD 


DT 
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口 ”overview: 表示 TextField 列 ， 并 包含 一 个 课程 的 概述 。 

口 created: 表示 课程 创建 的 日 期 和 时 间 。 鉴 于 auto_ now _add=True， 当 创建 新 对 象 
时 ， 该 字段 将 自动 由 Django 设置 。 

每 门 课程 可 划分 为 多 个 模块 。 因 此 ，Module 模块 包含 了 一 个 指向 Course 模块 的 

ForeignKey 字段 。 

打开 Shell 并 运行 下 列 命令 ， 进 而 创建 当前 应 用 程序 的 初始 迁移 。 


Python manage.PY makemigrations 
对 应 输出 结果 如 下 所 示 : 


Migrations for 'courses': 
0001 initial .py: 
- Create model Course 
- Create model Module 
- Create model Subject 
- Add field subject to course 


随后 ， 运 行 下 列 命令 并 向 当前 数据 库 应 用 全 部 迁移 结果 


Python manage.py migrate 


对 应 输出 结果 如 下 所 示 ， 其 中 包含 了 全 部 迁移 结果 
Applying courses.0001 initial... OK 


当前 ，courses 应 用 程序 的 模型 与 数据 库 同步 。 


10.2.1 在 管理 站 点 中 注册 模型 


下 面向 管理 站 点 中 添加 课程 模型 。 对 此 ， 编 辑 coursex 应 用 程序 目录 中 的 admin.py 
文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.contrib import admin 
from .models import Subject, Course, Module 


@admin.register (Subject) 

class SubjectAdmin (admin.ModelAdmin): 
list display = ['title', 'slug'] 
prepopulated fields = {'slug': ('title',)} 


class ModuleInline (admin.stackedInline): 
model = Module 
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@admin.register (Course) 
class CourseAdmin (admin.ModelAdmin): 


list display = ['title', 'subject', 'created'] 
list filter = ['created', '‘'subject'] 

search fields = ['title', 'overview'] 
prepopulated fields = {'slug': ('title’',)} 
inlines = [ModuleInline] 


课程 应 用 程序 模型 当前 已 在 管理 站 点 中 被 注册 。 注 意 ， 此 处 采用 @admin .register() 装 
饰 器 注册 管理 站 点 中 的 模型 。 


10.2.2 使 用 固定 文件 提供 模型 的 初始 数据 


某 些 时 候 ， 可 能 需要 利用 硬 编码 数据 预先 设置 数据 库 ， 当 自动 包含 项 目 设置 中 的 初 


始 数据 时 


， 这 十 分 有 用 ， 而 不 是 采用 手动 方式 对 其 进行 添加 。Django 提供 了 一 种 简单 的 


方法 ， 在 数据 库 和 固定 文件 之 间 加 载 和 转 储 数 据 。 


Dj 
文件 ， 


ango 提供 了 JSON、XML 或 YAML 格式 的 固定 文件 。 这 里 , 我 们 将 生成 一 个 固定 


并 针对 其 项 目 包含 多 个 初始 Subject 对 象 。 


首先 需要 利用 下 列 命令 创建 一 个 超级 用 户 ; 
Python manage.py createsuperuser 
随后 ， 利 用 下 列 命令 运行 开发 服务 器 : 


Python manage.PY runserver 


在 浏览 器 中 打开 http://127.0.0.1:8000/admin/courses/subject/， 并 利用 当前 管理 站 点 创 
建 多 个 科目 。 对 应 的 列表 显示 页 面 如 图 10.1 所 示 。 


Django administration 


Home » Courses ' Sebjects 


Select subject to change 
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在 Shell 中 运行 下 列 命令 : 


Python manage.py dumpdata courses --indent=2 


对 应 输出 结果 如 下 所 示 : 


{ 
"model": "courses.subject", 
bd le 
"eields": 4 
"title": "Mathematics", 
"slug": "mathematics" 
} 
}, 
"model": "courses.subject", 
ad 
nields™": { 
i 
"slug": "music" 
} 
Ds 
"model": "courses.subject", 
"pk": 3, 
"fields": { 
Vt "phyB" 
"slug": "physics" 
} 
}, 
"model": "courses.subject", 
"pk": 4, 
"Fields™: { 
"title": "Programming", 
"slug": "programming" 
Ls 
} 
] 


dumpdata 命令 将 数据 从 数据 库 转 储 至 标准 输出 中 , 默认 时 以 JSON 格式 进行 序列 化 。 
最 终 的 数据 结构 包含 了 与 模型 及 其 Django 字段 相关 的 信息 ， 进 而 能 够 将 其 加 载 至 数据 
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库 中 


通过 将 应 用 程序 名 称 提供 给 当前 命令 , 或 者 利用 app.Model 格式 指定 单一 的 输出 模型 ， 
可 将 输出 内 容 限 制 在 应 用 程序 模型 中 。 另 外 ， 还 可 通过 --format 标记 指定 对 应 格式 。 默 认 
状态 下 ，dumpdata 向 标准 输出 中 输出 序列 化 数据 。 然 而 ， 利 用 --output 标记 还 可 进一步 标 
明 输 出 文件 。--indent 可 用 于 指定 相应 的 缩 进 。 读 者 可 运行 python manage.py dumpdata--help 
命令 ， 以 查看 关于 dumpdata 参数 的 更 多 信息 。 

利用 下 列 命令 ， 可 将 固定 文件 转 储 值 orders 应 用 程序 的 fixtures/ 目 录 中 : 


mkdir courses/fixtures 

Python manage.py dumpdata courses --indent=2 -- 

output=courses/fixtures/subjects.json 

运行 开发 服务 器 并 利用 管理 站 点 移 除 所 创建 的 科目 。 随 后 ， 利 用 下 列 命令 将 固定 文 
件 加 载 至 数据 库 中 ; 

Python manage.py loaddata subjects .json 

所 有 的 Subject 读 写 将 包含 于 固定 文件 中 ， 并 加 载 至 数据 库 中 。 

默认 时 ，Dijango 查找 每 个 应 用 程序 fixtures/ 目 录 中 的 文件 , 我 们 可 对 loaddata 命令 指 
定 固定 文件 的 完整 路 径 。 除 此 之 外 ， 还 可 使 用 FIXTURE_DIRS 设置 通知 查找 固定 文件 的 
其 他 路 径 。 
© :ts: 

国定 文件 不 仅 对 初始 数据 的 设置 有 效 ， 同 时 还 针对 应 用 程序 或 者 测试 所 需 的 数据 提 
供 了 样本 数据 。 


关于 固定 文件 的 测试 应 用 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/ 
testing/tools/#fixture-loading 以 了 解 其 应 用 方式 。 

如 果 和 希望 将 固定 文件 加 载 至 模型 迁移 中 ， 可 查看 与 数据 迁移 相关 的 Django 文档 ， 对 
应 网 址 为 https://docs.djangoproject.com/en/2.0/topics/migrations/#data-migrations。 


10.3 创建 包含 多 样 化 内 容 的 模型 


本 节 将 向 课程 模块 中 添加 不 同 的 内 容 类 型 ， 如 文本 、 图 像 、 文 件 和 视频 ， 因 而 需要 
定义 一 种 通用 的 数据 模型 以 存储 各 类 数据 。 第 6 章 曾 讨论 了 通用 关系 的 便利 性 ， 同 时 创 
建 了 外 键 以 指向 任意 模型 的 对 象 。 这 里 将 生成 Content 模型 以 表示 模块 的 内 容 并 定义 通用 
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关系 ， 进 而 关联 各 类 内 容 。 
编辑 courses 应 用 程序 的 models.py 文件 ， 并 添加 下 列 导 入 语句 : 


from django.contrib.contenttypes.models import ContentType 
from django.contrib.contenttypes.fields import GenericForeignKey 


随后 ， 在 文件 结尾 处 添加 下 列 代码 : 


class Content (models.Model): 
module = models.ForeignKey (Module, 
related name="'contents', 
on_ delete=models .CASCADE) 
content type = models.ForeignKey (ContentType, 
on_delete=models .CASCADE) 
object id = models.PositiveIntegerField() 
item = GenericForeignKey('content type', 'object id') 

上 述 代码 定义 了 Content 模型 。 其 中 ， 一 个 模块 中 包含 了 多 项 内 容 ， 因 此 对 Module 
模型 定义 了 一 个 ForeignKey 字段 。 此 外 ， 还 设置 了 一 个 通用 关系 ， 进 而 关联 表示 不 同 内 
容 类 型 的 、 不 同 模块 的 对 象 。 需要 注意 的 是 , 我 们 需要 3 个 字段 设置 通用 关系 。 在 Content 
模块 中 ， 对 应 字段 包括 以 下 内 容 。 

口 content type: 表示 ContentType 模型 的 ForeignKey 字段 。 
口 object id， 表示 为 PositiveIntegerField， 以 存储 关联 对 象 的 主键 。 
口 item: 通过 整合 上 述 两 个 字段 ， 表 示 为 关联 对 象 的 GenericForeignKey 字段 。 

下 面 将 针对 每 种 内 容 类 型 使 用 不 同 的 模型 。 当 前 内 容 模型 包含 了 一 些 公共 字段 ， 但 
在 存储 实际 数据 方面 却 有 所 不 同 。 


10.3.1 使 用 模型 继承 机 制 


Django 支持 模型 的 继承 关系 ， 其 工作 方式 类 似 于 Python 语言 中 的 标准 类 继承 机 制 。 
关于 继承 关系 的 应 用 ，Django 提供 了 下 列 3 种 选择 方案 。 

口 ”抽象 模型 当 需 要 将 某 些 公 共 信 息 置 于 多 个 模型 中 时 ， 该 模型 十 分 有 用 。 对 于 
抽象 模型 ， 无 须 生成 数据 库 表 。 
口 ”多 表 模型 继承 : 当 层 次 结构 中 的 每 个 模型 自身 视 为 一 个 完整 的 模型 时 ， 即 可 使 
j 此 类 模型 。 此 时 ， 将 针对 每 个 模型 生成 一 个 数据 库 表 。 
口 “” 代 理 模型 ， 若 需 要 修改 模型 的 行为 ， 如 包含 附加 方法 、 修 改 默认 的 管理 器 ， 或 
者 使 用 不 同 的 元 数据 选项 时 ， 该 模型 较为 有 效 。 
下 面 将 对 每 种 模型 加 以 深入 讨论 。 
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1. 抽象 模型 

抽象 模型 表示 为 基 类 ， 其 中 定义 了 全 部 子 模型 中 需要 包含 的 字段 。Django 针对 抽象 
模型 不 会 创建 任何 数据 库 表 。 相 应 地 ， 数 据 库 将 针对 每 个 子 模型 生成 一 个 数据 库 表 ， 包 
括 继承 自 抽象 类 的 字段 ， 以 及 定义 于 子 模型 中 的 字段 。 

在 将 某 个 模型 标记 为 抽象 模型 时 ， 需 要 在 其 Meta 类 中 设置 abstract = True。Dijango 
将 对 此 予以 识别 ， 且 不 会 对 其 创建 数据 库 表 。 当 创建 子 模 型 时 ， 仅 需 定 义 该 抽象 模型 的 
子 类 即 可 。 

下 列 示例 展示 了 一 个 抽象 Content 模型 以 及 一 个 Text 子 模型 : 


from django.db import models 


class BaseContent (models .Model): 
title = models.CharField (max length=100) 
created = models.DateTimeField(auto now add=True) 


class Meta: 
abstract = True 


class Text (BaseContent): 
body = models.TextField() 


其 中 ，Django 仅 对 Text 模型 创建 了 一 个 表 ， 并 包含 了 title、created 和 body 字段 。 

2. 多 表 模 型 继承 关系 

在 多 表 模 型 继承 关系 中 ， 每 个 模型 对 应 于 一 个 数据 库 表 。 针 对 子 模型 中 的 父 模型 ， 
Django 创建 了 一 个 OneToOneField 字段 。 

当 采 用 多 表 继 承 时 ， 需 要 定义 现 有 模型 的 子 类 。Django 针对 原始 模型 和 子 模型 生成 
一 个 数据 库 表 。 下 列 示 例 代 码 显 示 了 多 表 继 承 机 制 : 


from django.db import models 


class BaseContent (models .Model): 
title = models.CharField (max length=100) 
created = models.DateTimeField(auto now add=True) 


class Text (BaseContent): 
body = models.TextField() 


Django 会 在 Text 模型 中 包含 一 个 自动 生成 的 OneToOneField 字段 , 并 针对 每 个 模型 
创建 一 个 数据 库 表 。 
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3. 代理 模型 

代理 模型 用 于 修改 模型 的 行为 ， 如 设置 附加 方法 或 者 不 同 的 元 数据 选项 ， 同 时 会 对 
原始 模型 的 数据 库 表 执行 相关 操作 。 当 创建 代理 模型 时 ， 需 要 向 模型 的 Meta 类 中 添加 
proxy=True。 

下 列 代码 示例 展示 了 如 何 创 建 代理 模型 : 


from django.db import models 
from django.utils import timezone 


Class BaseContent (models .Model): 
title = models.CharField (max length=100) 
created = models.DateTimeField(auto now add=True) 


class OrderedContent (BaseContent): 
class Meta: 
proxy = True 
ordering = ['created'] 


def created delta (self): 
return timezone.now() - self.created 
此 处 定义 了 一 个 OrderedContent 模型 ， 并 表示 为 Content 模型 的 代理 模型 。 该 模型 针 
对 QuerySet 提供 了 默认 排序 ， 以 及 一 个 created_delta() 方 法 。Content 和 OrderedContent 
模型 均 会 对 同一 首 个 数据 库 表 进 行 操作 。 通 过 任意 一 个 模型 ， 对 象 将 通过 ORM 被 访问 。 


10.3.2 ”创建 内 容 模型 


courses 应 用 程序 的 Content 模型 包含 了 通用 关系 ， 进 而 关联 不 同 的 内 容 关 系 。 下 面 
将 针对 每 种 内 容 类 型 创建 不 同 的 模型 。 所 有 的 内 容 模型 将 包含 某 些 公共 字段 以 及 附加 字 
段 ， 以 存储 自 定义 数据 。 此 处 将 创建 一 个 抽象 模型 ， 并 针对 全 部 内 容 模型 提供 相应 的 公 
共 字段 。 
编辑 courses 应 用 程序 的 models.py 文件 ， 并 向 其 中 添加 下 列 代码 : 
class ItemBase (models.Model): 
owner = models.ForeignKey (User, 
related name='s(class)s related', 
on delete=models .CASCADE) 


title = models.CharField (max length=250) 
created = models.DateTimeField (auto now add=True) 


小 
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updated = models.DateTimeField(auto now=True) 


class Meta: 
abstract = True 


def str (self): 
return self.title 


class Text (ItemBase): 
content = models.TextField() 


class File (ItemBase) : 
file = models.FileField(upload to='files') 


class Image (ItemBase) : 
file = models.FileField (upload to='images') 


class Video (ItemBase) : 
url = models.URLEField() 


在 上 述 代码 中 , 我 们 定义 了 一 个 名 为 IemBase 的 抽象 类 , 因此 在 其 Meta 类 中 设置 了 
abstract=True。 在 该 方法 中 ， 分 别 定义 了 owner、title、created、updated 字段 。 此 类 公共 
字段 将 用 于 全 部 内 容 类 型 。 其 中 ，owner 字段 可 存储 创建 当前 内 容 的 用 户 。 由 于 该 字段 定 
义 于 一 个 抽象 类 中 , 因而 需要 针对 每 个 子 模型 使 用 不 同 的 related_name。 对 于 related_name 
属性 中 的 model 类 名 ，Django 可 将 占 位 符 指 定 为 %(class)js。 据 此 ， 每 个 子 模型 的 
related_name 将 自动 生成 。 由 于 我 们 将 '%(class)s_related' 用 作 related_name， 因 而 子 模型 的 
逆向 关系 分 别 表示 为 text_related、file_related、image related、video _related。 

之 前 曾 定 义 了 4 个 不 同 的 内 容 模 型 ， 分 别 继 承 自 ItemBase 抽象 类 ， 有 具体 如 下 : 

口 ”Text 用 于 存储 文本 内 容 。 

口 File 用 于 存储 文件 ， 例 如 PDF 文件 。 

口 ”Image 存储 图 像 文件 。 

口 “Video 存储 视频 。 我 们 使 用 URLField 字段 提供 一 个 视频 URL。 

祭 了 自身 的 字段 之 外 ， 每 个 子 模型 还 包含 了 定义 于 ItemBase 类 中 的 字段 。 相 应 地 ， 
将 分 别针 对 Text、File、Image、Video 模型 创建 数据 库 表 。 由 于 ItemBase 定义 为 抽象 模 
型 ， 因 而 不 存在 与 该 模型 关联 的 数据 库 表 。 

编辑 之 前 创建 的 Content 模型 ， 并 修改 其 content type 字段 ， 如 下 所 示 : 


content type = models.ForeignKey (ContentType, 
on delete=models .CASCADE, 
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limit choices to={'model in':( 
"taxt.y 
'video', 
'image', 
Ee 


其 中 添加 了 limit_choices_to 参数 ， 并 限制 查找 可 用 于 通用 关系 中 的 ContentType 对 
象 。 这 里 采用 了 model _in 字段 ， 并 将 查询 结果 过 滤 为 包含 model 属性 〈 即 'text'、'"video'、 
"image' 或 'file') 的 ContentType 对 象 。 
接 下 来 创建 一 个 迁移 操作 ， 并 包含 之 前 添加 的 新 模型 。 在 命令 行 中 运行 下 列 命令 ; 


Python manage.PY makemigrations 
对 应 输出 结果 如 下 所 示 : 


Migrations for 'courses': 
courses/migrations/0002 content file image text video.py 
- Create model Content 
- Create model File 
- Create model Image 
- Create model Text 
- Create model Video 


随后 运行 下 列 命 令 并 使 用 新 的 迁移 结果 : 

Python manage.py migrate 

对 应 输出 结果 如 下 所 示 : 

Applying courses.0002 content file image text video... OK 

至 此 ， 我 们 创建 了 相关 模型 ， 并 可 向 课程 模块 中 添加 各 种 内 容 。 然 而 ， 此 类 模型 仍 
有 所 欠缺 。 也 就 是 说 ， 课 程 模型 和 内 容 应 遵循 特定 顺序 。 对 此 ， 可 添加 一 个 字段 并 对 其 
间 排 序 。 


10.3.3 ”创建 自 定义 模型 字段 


Django 包含 了 完整 的 模型 字段 集合 ， 并 以 此 构建 模型 。 此 外 ， 还 可 创建 自己 的 模型 
字段 ， 并 存储 自 定义 数据 或 者 对 现 有 字段 的 行为 进行 调整 。 
此 处 需要 设置 一 个 字段 ， 并 针对 对 象 定义 顺序 。 当 使 用 现 有 Django 字段 为 对 象 指定 
顺序 时 ， 一 种 较为 简单 的 方式 是 向 模型 添加 PositiveIntegerField。 通 过 使 用 整数 值 ， 即 可 
方便 地 设置 对 象 的 顺序 。 对 此 , 可 创建 一 个 继承 自 PositiveIntegerField 的 自 定义 顺序 字段 ， 
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进而 提供 附加 行为 。 

顺序 字段 涉及 两 种 相关 的 功能 ， 如 下 所 示 : 

口 “ 若 未 提供 特定 顺序 ， 将 自动 赋予 某 个 顺序 值 。 具 体 来 说 ， 若 未 采用 某 一 特定 顺 
序 存储 一 个 新 对 象 ， 字 段 将 被 自动 赋予 一 个 数字 ， 该 值 位 于 最 后 一 个 现 有 排序 
对 象 之 后 。 例 如 ， 如 果 存 在 两 个 顺序 分 别 为 1 和 2 的 对 象 ， 当 保存 第 3 个 对 象 
时 ， 如 果 未 提供 特定 的 顺序 ， 将 自动 向 其 赋予 顺序 3。 

口 相对 于 其 他 字段 的 顺序 对 象 。 课程 模块 将 根据 其 所 属 课程 和 模块 内 容 进 行 排序 。 

在 courses 应 用 程序 中 创建 新 的 fields.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.db import models 
from django.core.exceptions import ObjectDoesNotExist 


class OrderField (models.PositiveIntegerField): 
def init (self, for fields=None, *args, **kwargs): 
self.for fields = for fields 
super (OrderField, self). init (*args, **kwargs) 


def pre savel(self, model instance, add): 
if getattr (model instance, self.attname) is None: 
# no current value 
> 
qs = self.model.objects.all() 
if self.for fields: 
# filter by objects with the same field values 
# for, the fields in "for fields” 
query = {field: getattr (model instance, field)\ 
for field in self.for fields} 
qs = qs.filter (**query) 
# get the order of the last item 
last item = qs.latest (self.attname) 
value = last item.order + 1 
except ObjectDoesNotExist: 
Value = 0 
setattr (model instance, self.attname, value) 
return value 
LSe: 
return super (OrderField, 
self) .pre save (model instance, add) 


上 述 代码 表示 为 OrderField， 并 继承 自 Django 提供 的 PositiveIntegerField 字段 。 
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d 字段 接收 一 个 可 选 的 for_fields 参数 ， 以 表明 所 需 计 算 的 字段 。 
字段 重 载 了 PositiveIntegerField 字段 的 pre_save0 方 法 ， 并 在 该 字段 保存 至 数据 


库 之 前 被 执行 。 在 该 方法 中 ， 将 执行 下 列 操作 : 
(1) 检查 模型 实例 中 的 该 字段 是 否 已 存在 某 个 值 。 此 处 使 用 了 selfattname《〈 表 示 为 
针对 模型 字段 的 属性 名 ) 。 如 果 属 性 名 不 为 None, 将 根据 所 赋予 的 顺序 计算 相应 的 顺序 ， 


具体 如 下 : 


口 


口 


口 


口 
口 


创建 一 个 QuerySet 并 针对 字段 模型 检索 所 有 对 象 。 通 过 访问 selfmodel， 可 检索 
字段 所 属 的 模型 。 

我 们 根据 字段 的 当前 值 为 模型 字段 〈 定 义 于 该 字段 的 for fields 参数 中 ) 过 滤 
QuerySet。 据 此 ， 可 相对 于 给 定 字段 计算 顺序 。 

利用 last_item = qs.latest(self attname) 从 数据 库 中 计算 包含 最 先 顺序 的 对 象 。 如 果 
未 发 现 对 象 ， 可 将 当前 对 象 赋予 首位 并 向 其 赋予 顺序 0。 

如 果 对 象 存 在 ， 则 向 现 有 的 最 先 顺序 加 1。 

利用 setattr() 将 计算 后 的 顺序 赋予 模型 实例 中 的 字段 值 ， 并 返回 该 顺序 值 。 


(2) 如 果 模 型 实例 包含 当前 字段 值 ， 则 不 执行 任何 操作 。 


人 @@ 注意 ， 
当 创 
编码 数据 


关 替 


建 自 定义 模型 字段 时 ， 以 使 其 具备 通用 性 ， 并 避免 依赖 于 特定 模型 或 字段 的 硬 
， 最 终 ， 对 应 字段 应 适用 于 任意 模型 


编写 自 定义 模型 字段 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/howto/ 


custom-model-fields/ 以 了 解 更 多 信息 。 


10.3.4 


向 模块 和 内 容 对 象 中 添加 顺序 机 制 


下 面 


向 当前 模型 中 加 入 新 的 字段 。 对 此 ， 编 辑 courses 应 用 程序 的 models.py 文件 ， 


向 Module 模型 中 导入 OrderField 类 和 一 个 字段 ， 如 下 所 示 : 
from .fields import OrderField 


clas 


昌 


这 是 
行 计算 。 


5 Module (models.Model): 
基 ee 
order = OrderField(blank=True, for fields=['course']) 


， 新 字段 命名 为 order， 并 指定 对 应 顺序 根据 for_fields=['course"] 所 设置 的 课程 进 
这 意味 着 ， 新 模块 的 顺序 将 通过 “加 1” 的 方式 赋予 同一 Course 对 象 的 最 后 一 
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个 模块 ， 如 下 所 示 : 


class Module (models.Model) : 
Es 
def str (self): 
return '{}. {}'.format(self.order, self.title) 


除 此 之 外 ， 模 块 内 容 也 需要 遵循 特定 的 顺序 。 对 此 ， 可 向 Content 模型 中 添加 一 个 
OrderField 字段 ， 如 下 所 示 : 


class Content (models.Model): 
二 
order = OrderField (blank=True，for_fields=['module']) 


此 处 ， 对 应 顺序 将 根据 module 字段 进行 计算 。 最 后 ， 还 需要 针对 两 个 模型 添加 默认 
顺序 。 因 此 ， 可 向 Module 和 Content 模型 定义 下 列 Meta 类 : 


class Module (models.Model) : 
Re 
class Meta: 
ordering = ['order'] 


class Content (models.Model) : 
ks 
class Meta: 
ordering = ['order'] 


Module 和 Content 模型 如 下 所 示 : 


class Module (models .Model): 
course = models.ForeignKey (Course, 
related name='modules', 
on delete=models .CASCADE) 
title = models.CharField (max length=200) 
description = models.TextField (blank=True) 
order = OrderField(blank=True, for fields=['course']) 


class Meta: 
ordering = ['order'] 


def EP (Selfys 
return '{}. {}'.format (self.order, self.title) 


class Content (models.Model): 
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module = models.ForeignKey (Module, 
related name="'contents', 
on delete=models .CASCADE) 
content type = models.ForeignKey (ContentType, 
on delete=models .CASCADE, 
limit choices to={'model in’':( 
art 
'video', 
'image', 
'file')}) 


object id = models.PositiveIntegerField() 
item = GenericForeignKey('content type', 'object id') 
order = OrderField(blank=True, for fields=['module']) 


class Meta: 
ordering = ['order'] 


下 面 将 生成 新 的 模型 迁移 ， 进 而 反映 新 的 顺序 字段 。 打 开 Shell 并 运行 下 列 命令 : 
python manage.py makemigrations courses 
对 应 输出 结果 如 下 所 示 : 


You are trying to add a non-nullable field 'order' to content without a 
default; we can't do that (the database needs something to populate 
existing rows). 

Please select a fix: 

1) Provide a one-off default now (will be set on all existing rows with 
a null value for this column) 

2) Quit, and let me add a default in models.py 

Select an option: 


Django 显示 ,需要 针对 数据 库 中 的 现 有 行 ， 提供 新 order 字段 的 默认 值 。 如 果 该 字段 
包含 null=Tme， 将 接收 一 个 null 值 ，Django 会 自动 生成 迁移 ， 而 不 是 请 求 默认 值 。 我 们 
可 以 指定 一 个 默认 值 ， 或 者 删除 迁移 ， 并 在 生成 迁移 之 前 向 models.py 文件 中 的 order 字 
段 添加 一 个 default 属性 。 

输入 1 并 按 Enter 键 ， 进 而 针对 现 有 记录 提供 一 个 默认 值 。 对 应 输出 结果 如 下 所 示 : 

Please enter the default value now, as valid Python 

The datetime and django.utils.timezone modules are available, so you can 


do e.g. timezone.now 
Type 'exit' to exit this prompt 
>>> 


将 向 
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输入 0 并 以 此 表示 现 有 记录 的 默认 值 , 随后 按 下 Enter 键 . 对 于 Module 模型 , Django 
户 请 求 一 个 默认 值 。 选 择 第 1 个 选项 并 输入 0 作为 默认 值 。 最 终 ， 输 出 结果 如 下 


所 示 : 


动 计 


下 


Migrations for 'courses': 
courses/migrations/0003 auto 20180326 0704.py 
- Change Meta options on content 
- Change Meta options on module 
- Add field order to content 
- Add field order to module 


随后 ， 利 用 下 列 命令 使 新 的 迁移 生效 : 

python manage.py migrate 

该 命令 的 输出 结果 将 提示 用 户 ， 当 前 迁移 已 成 功 执行 ， 如 下 所 示 : 
Applying courses.0003 auto 20180326 0704... OK 

接 下 来 对 新 字段 进行 测试 。 打 开 Shell 并 运行 下 列 命令 : 

python manage.py shell 

同时 创建 新 的 课程 ， 如 下 所 示 : 


>>> from django .contrib.auth.models import User 

>>> from courses.models import Subject, Course, Module 

>>> user = User.objects.1last() 

>>> subject = Subject.objects.last() 

>>> cl = Course.objects.create (subject=subject, owner=user, title='Course 
1', slug='coursel') 


至 此 ， 我 们 在 数据 库 中 创建 了 一 门 新 课程 。 下 面向 该 课程 添加 模块 ， 并 查看 如 何 自 


- 算 对 应 的 顺序 。 对 此 ， 我 们 创建 一 个 初始 模块 并 检查 其 顺序 ， 如 下 所 示 : 


>>> ml = Module.objects .create (Course=cl1，title='Module 1') 
>>> ml .order 


0 
其 中 ，OrderField 将 其 值 设置 为 0 一 一 这 是 第 1 个 针对 给 定 课程 创建 的 Module 对 象 。 
针对 同一 课程 生成 第 2 个 模块 ， 如 下 所 示 : 


>>> m2 = Module.objects .create (Course=c1，title='Module 2') 
>>> m2 .order 
和 
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同时 


的 对 


门 课 
中 设 


OrderField 计算 下 一 个 顺序 值 , 为 现 有 对 象 的 最 先 顺序 加 1。 接 下 来 创建 第 3 个 模块 ， 
强制 指定 一 个 特定 的 顺序 ， 如 下 所 示 : 
>>> m3 = Module.objects .create (course=cl，title='Module 3', order=5) 


>>> m3.order 
5 


如 果 指 定 了 一 个 自 定义 顺序 ，OrderField 字段 并 不 会 产生 干扰 ， 并 使 用 赋予 order 中 
应 值 。 

下 面 创建 第 4 个 模块 ， 如 下 所 示 : 

>>> m4 = Module.objects .create (Course=cl，title='Module 4') 


>>> m4 .order 
6 


该 模块 的 顺序 将 被 自动 设置 。OrderField 字段 并 不 会 保证 全 部 顺序 值 均 处 于 连续 状 


。 但 是 ， 该 字段 遵循 现 有 的 顺序 值 ， 并 且 总 是 根据 现 有 的 最 先 顺序 指定 下 一 个 顺序 。 


下 面 创建 第 2 门 课程 ， 并 向 其 中 添加 下 列 模块 : 


>>> c2 = Course.objects.create(subject=subject, title='Course 2', 
slug='course2', owner=user) 

>>> m5 = Module.objects.create(course=c2, title='Module 1') 

>>> m5 .order 

0 


当 计 算 新 模块 的 顺序 时 ， 对 应 字段 仅 考察 属于 同一 门 课程 的 现 有 模块 。 由 于 这 是 第 2 
程 的 第 1 个 模块 ， 最 终 顺 序 值 为 0， 其 原因 在 于 ， 我 们 在 Module 模型 的 order 字段 
置 了 for fields=['course']。 

至 此 ， 我 们 已 经 成 功 地 创建 了 第 1 个 自 定 义 模型 字段 。 


10.4 创建 CMS 


上 述 内 容 创建 了 通用 的 数据 模型 ， 本 节 将 尝试 构建 CMS。CMS 允许 教师 创建 课程 ， 


内 容 进行 管理 ， 其 中 涉及 下 列 各 项 功能 : 
登录 CMS 。 
列 出 教师 创建 的 课程 。 


生成 、 编 辑 和 删除 课程 。 
向 菜 一 门 课程 中 加 入 模块 并 对 其 


DODDODD 


由 


新 排序 。 
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口 “ 向 每 个 模块 添加 不 同 的 内 容 类 型 ， 并 对 其 重新 排序 。 
10.4.1 添加 验证 系统 


本 节 向 当前 平台 中 加 入 Django 的 验证 系统 。 
模型 实例 。 因 此 ， 可 通过 django.contrib.auth 的 验证 视图 登录 网 站 。 


EE] 


nn 


a 


中 , 教师 和 学 生 表示 为 Django 的 User 


编辑 educa 项 目的 urlspy 文件 ， 并 添加 Django 验证 系统 的 login 和 logout 视图 ， 如 


下 所 示 : 
from django.contrib import admin 


from django.urls import path 
from django.contrib.auth import views as auth views 


urlpatterns = [ 

path('accounts/login/', auth views.LoginView.as view(), 
name='login'), 

path('accounts/logout/', auth views.LogoutView.as view(), 
name='logout'), 

path('admin/', admin.site.urls), 
] 


10.4.2 ”创建 验证 模板 


在 courses 应 用 程序 目录 中 生成 下 列 文件 结构 : 


templates/ 
base.html 
registration/ 
login.html 
logged out.html 


在 构建 授权 模板 之 前 ， 需 要 针对 当前 项 目 设置 基 模 板 。 对 此 ， 编 辑 base.html 模板 ， 


并 向 其 中 添加 下 列 内 容 : 


{ 当 load staticfiles %} 
<!DOCTYPE html> 
<html> 
<head> 
<meta charset="utf-8" /> 
<title>{% block title %}Educa{% endblock $%$}</title> 
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<link href="{% static "css/base.css" $}" rel="stylesheet"> 
</head> 
<body> 
<div id="header"> 
<a href="/" class="1ogo">Educa</a> 
<ul class="menu"> 
{$$ if request.user.is authenticated %} 
<li><a href="{% url "logout" $%}">Sign out</a></1i> 
{% else $} 
<li><a href="{%$ url "login" %}">Sign in</a></1i> 
{$$ endif %} 
</ul> 
</div> 
<div id="content"> 
{ block content %} 
{% endblock %} 
</div> 


<script src="https://ajax.googleapis.com/ajax/libs/jquery/ 
3.3.1/jquery.min.js"></script> 
<script> 
$ (document) .ready (function() { 
{$$ block domready $} 
{$$ endblock %$} 
ns 
</script> 
</body> 
</html> 


上 述 代码 定义 了 基 模 板 ， 其 他 模板 可 在 此 基础 上 进行 扩展 。 在 该 模板 中 ， 定 义 了 下 


列 块 。 
口 title: 用 于 为 每 个 页 面 添 加 自 定义 标题 的 其 他 模板 块 。 


口 。”content: 表示 为 内 容 的 主 块 。 扩 展 了 基 模 板 的 所 有 模板 应 向 该 块 中 添加 内 容 。 
口 ”domready: 位 于 jQuery 的 $document.ready() 函 数 中 ， 当 DOM 完成 加 载 过 程 后 可 


执行 代码 。 


I 


于 该 模板 中 的 CSS 样式 位 于 courses 应 用 程序 的 static/ 目 录 中 ， 读 者 可 查看 本 章 示 


例 代码 以 了 解 具体 内 容 。 同 时 ， 可 将 static/ 目 录 复制 至 当前 项 目的 同一 目录 中 ， 并 对 其 加 


以 使 用 。 
编辑 registration/login.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


东 
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{$$ extends "base-htm1l" $} 
{% block title %$}Log-in{% endblock %$} 


{% block content $%} 
<hl>Log-in</hl> 
<div class="module"> 
{ 当 if form.errors %} 
<p>Your username and password didn't match. Please try again.</p> 
{$$ else $%} 
<p>Please, use the following form to log-in:</p> 
{% endif %} 
<div class="login-form"> 
<form action="{% url 'login' %}" method="post"> 
{{ form.as p }} 
{ csrf token %} 
<input type="hidden" name="next" value="{{ next }}" /> 
<p><input type="submit" value="Log-in"></p> 
</form> 
</div> 
</div> 
{% endblock %$} 


这 可 视 为 Django login 视图 中 的 标准 登录 模板 。 
编辑 registration/logged_out.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{S$ extends "base.htm]l™ %} 
{% block title %}Logged out{% endblock %} 


{$$ block content %} 
<hl>Logged out</h1l> 
<div class="module"> 
<p>You have been successfully logged out. 
You can <a href="{% Url "login" %}">log-in again</a>.</p> 
</div> 
{$$ endblock $} 


在 用 户 注销 后 ， 将 向 其 显示 上 述 模板 。 利 用 下 列 命令 运行 开发 服务 器 : 


python manage.py runserver 


pa 


10.2 所 示 。 


在 浏览 器 中 打开 http://127.0.0.1:8000/accounts/login/， 对 应 登录 页 面 如 
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Log-in 
Please, use the following form to log-in: 


Username: 


Password: 


图 10.2 


10.4.3 ”设置 基于 类 的 模板 


本 节 将 构建 视图 ， 进 而 创建 、 编 辑 、 删 除 课程 。 对 此 ， 我 们 将 使 用 基于 类 的 视图 。 
编辑 courses 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.views.generic.list import ListView 
from .models import Course 


class ManageCourseListView (ListView): 
model = "Course 
template name = 'courses/manage/course/list.html' 


def get queryset (self): 
qs = super (ManageCourseListView, self) .get queryset() 
return qs.filter (owner=self.request .user) 
上 述 代码 定义 了 ManageCourseListView 模板 , 该 模板 继承 自 Django 的 通用 ListView。 
此 处 重 载 了 该 视图 的 get_queryset( 方 法 ， 且 仅 检索 当前 用 户 创 建 的 课程 。 为 了 防止 用 户 
编辑 、 更 新 或 删除 其 他 教师 创建 的 课程 ， 还 需要 重 载 创建 、 更 新 、 删 除 视图 中 的 
get_queryset() 方 法 。 当 需要 针对 多 个 基于 类 的 视图 提供 特定 的 行为 时 ， 建 议 使 用 混合 类 


(mixins) 。 
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10.4.4 ”针对 基于 类 的 视图 使 用 混合 类 


混合 类 定义 为 针对 某 个 类 的 多 重 继承 结果 ， 并 可 以 此 提供 公共 离散 功能 ， 这 些 功 能 
添加 到 其 他 混合 类 中 以 定义 类 的 行为 。 混 合 类 的 应 用 主要 涉及 以 下 两 种 情形 : 

口 ”针对 某 个 类 ， 需 要 提供 多 项 可 选 功能 。 

口 ”使 用 多 个 类 中 的 特定 功能 。 

Django 包含 了 多 种 混合 类 ， 并 可 向 基于 类 的 视图 中 添加 附加 功能 。 关 于 混合 类 ， 读 
者 可 访问 https://docs.djangoproject.com/en/2.0/topics/class-based-views/mixins/ 以 了 解 更 多 


信息 。 


| 


下 面 将 创建 一 个 混合 类 ， 以 包含 一 个 公共 行为 ， 并 在 课程 的 视图 中 对 其 加 以 使 用 。 
对 此 ， 编 辑 courses 应 用 程序 的 views/py 文件 ， 并 按照 下 列 方式 对 其 进行 修改 : 


from django.urls import reverse lazy 

from django.views.generic.list import ListView 

from django.views.generic.edit import CreateView, UpdateView, \ 
DeleteView 


from .models import Course 


class OwnerMixin (object): 
def get queryset (self): 
qs = super (OwnerMixin, self) .get queryset() 
return qs.filter (owner=self.request.user) 


class OwnerEditMixin (object): 
def form valid(self, form): 
form.instance.owner = self.request.user 
return super (OwnerEditMixin, self).form valid (form) 


class OwnerCourseMixin (OwnerMixin): 
model = Course 


class OwnerCourseEditMixin (OwnerCourseMixin, OwnerEditMixin): 
fields = ['subject', 'title', 'slug', 'overview'] 
Success url = reverse lazy('manage course list') 
template name = 'courses/manage/course/form.html' 


class ManageCourseListView (OwnerCourseMixin, ListView): 
template name = 'courses/manage/course/list.html' 
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class CourseCreateView (OwnerCourseEditMixin, CreateView): 
pass 


class CourseUpdateView (OwnerCourseEditMixin, UpdateView): 
pass 


class CourseDeleteView (OwnerCourseMixin, DeleteView): 

template name = 'courses/manage/course/delete.html' 
success url = reverse lazy('manage course list') 

上 述 代码 创建 了 OwnerMixin 和 OwnerEditMixin 混合 类 ， 并 与 Django 提供 的 
ListView、CreateView、UpdateView、DeleteView 视图 结合 使 用 。 其 中 ，OwnerMixin 实 
现 了 get_queryset() 方 法 ， 该 方法 供 视 图 加 以 使 用 ， 以 获得 基 QuerySet。 当 前 混合 类 将 对 
载 该 方法 ， 通 过 owner 属性 过 滤 对 象 ， 并 检索 属于 当前 用 户 (request.user) 的 对 象 。 

OwnerEditMixin 则 实现 了 form_valid0 方 法 , 该 方法 供 使 用 Django ModelFormMixin 混 
合 类 的 视图 加 以 使 用 。 也 就 是 说 ， 包 含 表单 和 模型 表单 的 视图 ， 如 CreateView 和 
UpdateView。 若 提交 后 的 表单 有 效 ， 那 么 orm_valid0 方 法 将 被 执行 。 该 方法 的 默认 行为 是 
存储 实例 (如 模型 表单 ， 并 将 用 户 重 定向 至 success_url。 我 们 重 载 了 该 方法 ， 并 自动 将 
当前 用 户 设 置 在 所 保存 对 象 的 owner 属性 中 。 据 此 ， 在 保存 时 可 自动 设置 对 象 的 所 有 者 。 

OwnerMixin 类 可 用 于 与 模型 (包含 了 owner 属性 ) 交互 的 视图 。 

除 此 之 外 ， 我 们 还 定义 了 继承 自 OwnerMixin 的 OwnerCourseMixin 类 ， 并 针对 子 视 
图 提供 了 model 属性 ， 即 针对 QuerySet 使 用 的 模型 ， 并 可 供 全 部 视图 使 用 。 

同时 ， 我 们 还 定义 了 包含 下 列 属性 的 OwnerCourseEditMixin 混合 类 : 

口 fields: 表示 模型 字段 ， 并 构建 CreateView 和 UpdateView 视图 的 模型 表单 。 

口 success_url: 用 于 CreateView 和 UpdateView， 并 在 表单 成 功 提交 后 重 定向 用 户 。 

我 们 使 用 了 一 个 包含 manage_course_ list 名 称 的 URL《〈 稍 后 将 对 此 创建 ) 。 
最 后 将 创建 作为 OwnerCourseMixin 子 类 的 下 列 视图 : 
口 ManageCourseListView: 列 出 用 户 创建 的 课程 。 该 视图 继承 自 OwnerCourseMixin 
和 ListView。 

口 ”CourseCreateView: 可 编辑 现 有 的 Course 对 象 该 视图 继承 自 OwnerCourseEditMixin 
和 UpdateView。 

口 ”CourseDeleteView: 该 视图 继承 自 OwnerCourseMixin 和 通用 DeleteView， 并 定 
义 了 success url， 以 在 对 象 删除 后 重 定向 用 户 。 


是 
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10.4.5 ”分 组 和 权限 


5 309s 


前 述 内 容 讨论 了 基本 的 视图 进而 对 课程 进行 管理 。 当 前 ， 任 意 用 户 均 可 
视图 。 对 此 ， 我 们 需要 对 视图 进行 适当 限制 。 具 体 来 说 ， 仅 教师 具有 课程 的 创建 和 管理 


权限 。Django 的 验证 系统 包含 了 权限 系统 ， 从 而 可 向 上 


将 对 教师 这 一 类 用 户 创建 一 个 分 组 ， 并 赋予 权限 以 创建 、 更 新 、 删 除 课程 。 
运行 开发 服务 器 ， 在 浏览 器 中 打开 http://127.0.0.1:8000/admin/auth/group/add/ 并 创建 


新 的 Group 对 象 。 添 加 名 称 Instructors， 除 了 Subject 模型 的 权限 之 外 ， 选 择 courses 应 用 


程序 的 全 部 权限 ， 如 图 10.3 所 示 。 


admin |log entry | Can add log entry 
admin |log entry | Can change log entry 
admin | log entry | Can delete log entry 
auth 1group | Can add group 

auth | group | Can change group 

auth | group | Can delete group 

auth | permission | Can add permission 
auth | permission | Can change permission 
auth | permission | Can delete permission 
auth | user | Can add user 

auth | user | Can change user 


Chooseall © 


访问 这 一 类 


户 和 分 组 赋予 相应 的 权限 。 本 节 


courses | content | Can add content 
courses | content | Can change content 
courses | content | Can delete content 
courses | course | Can add course 
Courses | course | Can change course 
Courses | course | Can delete course 
courses |file | Can add file 

courses | fe | Can change file 

courses | file | Can delete file 

courses |image | Can add image 
courses | image | Can change image 


@ Remove all 


Save and add another Save and continue editing 


图 10.3 


从 图 10.3 中 可 以 看 出 ， 每 种 模型 存在 3 种 不 同 的 权限 ， 即 can add、can change、can 


delete。 在 选择 了 分 组 的 权限 后 ， 单 击 SAVE 按钮 。 


Django 针对 模型 采用 自动 方式 创建 权限 ， 但 上 


j 户 也 可 自 定 义 权 限 。 关 于 


F 自 定义 权限 


的 添加 方式 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/topics/auth/customizing/ 


#custom-permissions 以 了 解 更 多 内 容 。 


打开 http://127.0.0.1:8000/admin/auth/user/add/ 他 
加 Instructors 分 组 ， 如 图 10.4 所 示 。 


建 一 个 新 用 户 。 编 辑 该 


户 并 向 其 添 
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Groups: 


Available groups © Chosen groups © 


Instructors 


图 10.4 


这 里 ， 用 户 继承 了 其 所 属 的 分 组 权限 ， 但 也 可 通过 管理 站 点 向 单个 用 户 添 加 个 人 权 


限 。 如 果 is_superuser 设置 为 True， 那 么 ， 用 户 将 自动 包含 全 部 权限 。 


相应 地 ， 我 们 可 限制 对 视图 的 访问 权限 ， 也 就 是 说 ， 仅 包含 相应 权限 的 用 户 可 添加 、 
更 改 或 删除 Course 对 象 。 对 此 ， 可 采用 django.contrib.auth 提供 的 两 个 混合 类 限制 对 视图 


的 访问 ， 有 具体 如 下 。 
口 LoginRequiredMixin: 复制 login_required 装饰 器 的 各 项 功能 。 


口 “PermissionRequiredMixin: 将 视图 访问 权限 授予 具有 特定 权限 的 用 户 。 注 意 ， 


级 用 户 自动 拥有 全 部 权限 。 
编辑 courses 应 用 程序 的 views.py 文件 ， 并 添加 下 列 导 入 语句 : 
from django.contrib.auth.mixins import LoginRequiredMixin, \ 
PermissionRequiredMixin 
令 OwnerCourseMixin 继承 自 LoginRequiredMixin， 如 下 所 示 : 


class OwnerCourseMixin (OwnerMixin, LoginRequiredMixin): 
model = Course 
fields = ['subject', 'title', 'slug', 'overview'] 
success url = reverse lazy('manage course list') 


随后 ， 添 加 permission_required 属性 ， 以 创建 、 更 新 、 删 除 视图 ， 如 下 所 示 : 


class CourseCreateView (PermissionRequiredMixin, 
OwnerCourseEditMixin, 
CreateView): 
permission required = 'courses.add course' 


class CourseUpdateView (PermissionRequiredMixin, 
OwnerCourseEditMixin, 
UpdateView): 
Permission required = 'courses.change course' 


国 
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class CourseDeleteView (PermissionRequiredMixin, 
OwnerCourseMixin, 
DeleteView): 
template name = 'courses/manage/course/delete.html' 
success url = reverse lazy('manage course list') 
Permission required = 'courses.delete course' 


PermissionRequiredMixin 检测 访问 视图 的 用 户 是 否 具 有 permission required 属性 中 指 


定 的 权限 。 对 应 视图 仅 供 具 有 适当 权限 的 用 户 访 问 。 
下 面 针对 相关 视图 创建 URL。 在 courses 应 用 程序 目录 中 创建 新 文件 ， 将 其 命名 为 


urls.py 并 向 其 中 添加 下 列 代码 : 


from django.urls import path 
from . import views 


urlpatterns = [ 
path('mine/', 
views.ManageCourseListView.as view(), 
name='manage course list'), 
path('create/', 
Views.CourseCreateView.as view(), 
name="'course create'), 
path('<pk>/edit/', 
Views.CourseUpdateView.as view(), 
name='course edit'), 
path('<pk>/delete/', 
Views.CourseDeleteView.as view(), 
name='course delete'), 


] 
对 于 课程 视图 的 显示 、 创 建 、 编 辑 和 删除 功能 ， 上 述 代 码 表示 为 相应 的 URL 路 径 。 
编辑 educa 项 目的 urls.py 文件 ， 并 包含 courses 应 用 程序 的 URL 路 径 ， 如 下 所 示 : 


from django.urls import path, include 


urlpatterns = [ 
path('accounts/login/', auth views.LoginView.as view(), name='login'), 


path('accounts/logout/', auth views.LogoutView.as view(), 
name="'logout"'), 

path('admin/', admin.site.urls), 

path('course/', include('courses.urls')), 
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另外 ， 还 需要 针对 此 类 视图 创建 模板 。 对 此 ， 在 courses 应 用 程序 的 templates/ 目 录 


二 
UD 
全 


E 成 下 列 目录 和 文件 : 


courses/ 


manage/ 
course/ 
list.html 
form.html 
delete.html 


编辑 courses/manage/course/list.html 模板 ， 并 向 其 中 添加 下 列 代码 : 
{% extends "base.htm1l" %} 


{% block title %}My courses{% endblock %} 


{% block content $%} 
<hl>My courses</h1l> 


<div class="module"> 


{% for course in object list %} 
<div class="course-info"> 
<h3>{{ course.title }}</h3> 
<p> 
<a href="{% url "course edit" course.id %}">Edit</a> 
<a href="{% url "course delete" course.id %}">Delete</a> 
</p> 
</div> 
{% empty %} 
<p>You haven't created any courses yet.</p> 
{$$ endfor 委 } 
<p> 
<a href="{% Url "course create" $%}" class="button">Create new 


course</a> 


</p> 


</div> 


{名 


endblock %} 


上 述 代码 表示 为 针对 ManageCourseListView 视图 的 模板 。 在 该 模板 中 ， 列 出 了 当前 


新 课程 


用 户 创建 的 对 应 课程 。 其 中 分 别 包含 了 一 个 编辑 或 删除 每 门 课程 的 链接 ， 以 及 一 个 创建 


的 链接 。 


利 


python manage.py runserver 命令 运行 开发 服务 器 。 在 浏览 器 中 打开 http://127.0.0.1: 
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8000/accounts/login/?next=/course/mine/， 并 以 Instructors 分 组 用 户 身 份 登录 。 在 登录 后 ， 
将 被 重 定向 至 http://127.0.0.1:8000/course/mine/ 的 URL， 如 图 10.5 所 示 。 


My courses 


You haven't created any courses yet. 


图 10.5 


该 页 面 显 示 了 当前 用 户 创建 的 全 部 课程 。 
对 于 创建 、 更 新 课程 视图 的 表单 ， 下 面 生成 模板 并 对 其 予以 显示 。 编 辑 courses/manage/ 
course/form.html 模板 并 编写 下 列 代码 : 


{% extends "base.htm]l" $%} 


{% block title %} 
{% if object %} 
Edit course "{{ object.title }}" 
{% else $} 
Create a new course 
{% endif %} 
{s% endblock 要 } 


{% block content $%} 
<hl> 
{% if object %} 
Edit course "{{ object.title }}" 
{S$ else $} 
Create a new course 
{$$ endif %} 
</h1> 
<div class="module"> 
<h2>Course info</h2> 
<form action="." method="post"> 
{{ form.as p }} 
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{ 委 csrf token $} 
<p><input type="submit" value="Save course"></p> 
</form> 
</div> 
{$$ endblock 要 } 


form.html 模板 用 于 CourseCreateView 和 CourseUpdateView 视图 。 在 该 模板 中 , 将 检 
测 object 变量 是 否 处 于 当前 上 下 文中 。 若 是 ， 则 可 更 新 已 有 课程 ， 并 将 其 用 于 页 面 标题 
中 。 否 则 ， 将 创建 新 的 Course 对 象 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/course/mine/， 并 单 击 CREATE NEW COURSE 
按钮 ， 对 应 结果 如 图 10.6 所 示 。 


Create a new course 


Course info 


Subject: 


Overview: 


图 10.6 


填写 表单 并 单 击 SAVE COURSE 按钮 ， 对 应 课程 将 被 保存 。 随 后 用 户 将 被 重 定向 至 
课程 列表 页 面 ， 如 图 10.7 所 示 。 
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My courses 


Django course 
Edit Delete 


CREATE NEW COURSE 


图 10.7 


接 下 来 ， 单 击 生 成 后 的 课程 的 Edit 链接 ， 将 会 再 次 显示 该 表单 ， 但 此 时 将 对 已 有 的 


Course 


对 象 进行 编辑 ， 而 不 是 创建 该 对 象 。 


最 后 ， 编 辑 courses/manage/course/delete.html 模板 并 向 其 中 添加 下 列 代码 : 


{名 


{% 


{% 


extends "base.html" %} 
block title %}Delete course{% endblock %} 


block content %} 


<hl>Delete course "{{ object.title }}"</hl> 


<div class="module"> 


< 
{ 多 


上 述 代 码 表 示 为 CourseDeleteView 视图 的 模板 ， 该 视图 继承 自 Django 提供 


DeleteV: 


打开 浏览 器 并 单 击 Delete 链接 ， 对 应 的 确认 页 面 如 图 10.8 所 示 。 
单 击 CONFIRM 按钮 后 ， 对 应 课程 将 被 删除 ， 同 时 将 被 再 次 重 定向 至 课程 列表 页 


至 


<form action="" method="post"> 
{$$ csrf token %} 
<p>Are you sure you want to delete "{{ object }}"?</p> 
<input type="submit" class"button" value="Confirm"> 
</form> 
/div> 
endblock 和 当 } 


by 


iew， 在 经 过 用 户 确 认 后 将 删除 一 个 对 象 。 


o 


tt， 教 师 可 创建 、 编 辑 、 删 除 课程 。 接 下来， 我 们 将 使 用 CMS 进而 向 课程 添加 模 


块 和 相关 内 容 。 下 面 首先 讨论 课程 模块 的 管理 行为 。 
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Delete course "Django course 


Are you sure you want to delete "Django course"? 


CONFIRM 


图 10.8 


10.5 管理 课程 模块 和 内 容 


本 节 将 构建 一 个 系统 ， 并 管理 课程 模块 及 其 内 容 。 对 此 ， 我 们 需要 创建 表单 ， 并 用 


于 管理 每 门 课程 的 多 个 模块 ， 以 及 针对 每 个 模块 的 不 同 内 容 类 型 。 另 外 ， 模 块 和 内 容 需 
要 包含 特定 的 顺序 ， 同 时 应 可 通过 CMS 对 其 进行 重新 排序 。 


10.5.1 针对 课程 模块 使 用 表单 


Django 包含 了 抽象 层 ， 并 可 与 同一 页 面 中 的 多 个 表单 协同 工作 ， 这 一 类 表单 分 组 称 


作 表 单 集 。 表 单 集 负责 管理 特定 Form 或 ModelForm 的 多 个 实例 。 全 部 表单 均一 次 性 提 
交 ， 表 单 集 则 负责 处 理 初始 时 的 表单 显示 数量 、 限 制 可 提交 的 最 大 表单 数量 并 对 全 部 表 


单 进行 验证 。 


表单 集 包含 了 is_valid() 方 法 ， 并 一 次 性 地 验证 所 有 表单 。 此 外 ， 还 可 针对 表单 提供 


初始 数据 ， 并 指定 所 显示 的 额外 空 表单 的 数量 。 


关于 表单 集 和 模型 表单 集 ， 读 者 可 分 别 访问 https://docs.djangoproject.com/en/2.0/ 


topics/forms/formsets/A https://docs.djangoproject.com/en/2.0/topics/forms/modelforms/#model- 
formsets 以 了 解 更 多 信息 。 


理 。 


由 于 一 门 课程 可 划分 为 不 同 数量 的 模块 ， 因 而 较 好 的 方法 是 使 用 表单 集 对 其 进行 管 
对 此 ， 可 在 courses 应 用 程序 目录 中 创建 forms.py 文件 ， 并 向 其 中 添加 下 列 代码 : 
from django import forms 


from django.forms.models import inlineformset factory 
from .models import Course, Module 
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ModuleFormSet = inlineformset factory (Course, 
Module, 
fields=['title', 
'description'], 
extra=2, 
can delete=True) 
上 述 代码 定义 了 ModuleFormSet， 我 们 将 采用 Diango 提供 的 inlineformset_factory0) 函 数 
对 其 加 以 构建 。 内 联 表单 集 表示 为 表单 集 之 上 的 小 型 抽象 层 ， 并 可 简化 与 关联 对 象 的 操 
作 过 程 。 对 于 与 Course 对 象 关联 的 Module 对 象 ， 该 函数 可 采用 动态 方式 构建 模型 表单 集 。 
表单 集 的 构建 过 程 涉及 以 下 参数 。 
口 fields: 表单 集 的 每 个 表单 中 所 包含 的 字段 。 
口 extra: 可 设置 附加 空 表 单 的 数量 ， 进 而 在 表单 集中 予以 显示 。 
口 “can_delete: 若 该 参数 设置 为 True，Django 将 针对 每 个 表单 包含 一 个 布尔 字段 ， 
并 以 复 选 框 输入 形式 加 以 显示 。 据 此 ， 用 户 可 标记 希望 删除 的 对 象 。 
编辑 course 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 
from django.shortcuts import redirect, get object or 404 


from django.views.generic.base import TemplateResponseMixin, View 
from .forms import ModuleFormSet 


class CourseModuleUpdateView (TemplateResponseMixin, View): 
template name = 'courses/manage/module/formset.html' 
course = None 


def get formset (self, data=None): 
return ModuleFormSet (instance=self .course, 
data=data) 


def dispatch(self, request, pk): 
self.course = get object or 404(Course, 
id=pk, 
owner=request .user) 
return super (CourseModuleUpdateView, 
self) .dispatch (request, pk) 


def get (self, request, *args, **kwargs): 
formset = self.get formset () 
return self.render to response({'course': self.course, 
'formset': formset}) 
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def post (self, request, *args, **kwargs): 
formset = self.get formset (data=request .POST) 
if formset.is valid() : 
formset .save () 
return redirect('manage course list') 
return self.render to response({'course': self.course, 
'formset': formset}) 


CourseModuleUpdateView 视图 负责 处 理 表单 集 ， 并 针对 特定 课程 添加 、 更 新 、 删 除 


模块 。 该 视图 继承 自 下 列 混合 类 和 视图 。 


口 


口 


bl 


日 


TemplateResponseMixin: 该 混合 类 负责 显示 模板 并 返回 一 个 HTTP 响应 ， 其 
需要 使 用 到 template name 属性 ， 以 此 表明 所 显示 的 模板 ， 并 提供 了 一 个 
render to response() 方 法 来 传递 上 下 文 以 显示 模板 。 

View: Django 提供 的 基于 类 的 基 视 图 。 


在 上 述 视 图 中 ， 需 要 实现 下 列 各 方法 。 


口 


口 


get_formset(): 在 构建 表单 集 时 可 避免 重复 代码 。 针 对 包含 可 选 数据 的 给 定 

Course 对 象 ， 我 们 需要 创建 一 个 ModuleFormSet 对 象 。 

dispatch(): 该 方法 由 View 类 提供 ， 并 接收 一 个 HITP 请 求 及 其 参数 ， 并 尝试 委 

托 至 与 所 用 HTTP 方法 匹配 的 小 写 方法 ， 即 GET 请 求 将 被 委托 至 get( 方 法 ， 

POST 请 求 将 委托 至 post() 方 法 。 在 该 方法 中 , 我 们 使 用 get_object_or_4040 快 捷 

函数 ， 并 针对 既定 id 参数 (来 属于 当前 用 户 ) 获取 Course 对 象 。 由 于 需要 针对 

GET 和 POST 请 求 检索 课程 , 因而 需要 将 此 类 代码 纳入 dispatch0 方 法 中 。 此 外 ， 

我 们 将 其 保存 至 视图 的 course 属性 中 ， 以 便 其 他 方法 也 可 对 其 加 以 访问 。 

get(); 执行 于 GET 请 求 。 我 们 将 构建 一 个 空 ModuleFormSet 表单 集 ， 并 利用 

TemplateResponseMixin 提供 的 render to_response() 方 法 ， 连 同 当前 Course 对 象 

将 其 显示 于 模板 中 。 

post(): 执行 于 POST 请 求 。 该 方法 将 执行 下 列 操作 ; 

> 利用 所 提交 的 数据 构建 ModuleFormSet 实例 。 

> 执行 表单 集 的 is_valid0 方 法 ， 并 验证 其 中 的 全 部 表单 。 

> 若 表 单 集 有 效 ， 将 调用 save0 方 法 对 其 予以 保存 。 此 时 ， 任 何 产 生 的 变化 ， 
如 添加 、 更 新 或 删除 模块 ， 都 将 作用 于 数据 库 上 。 随 后 ， 用 户 将 被 重 定 癌 
至 manage_course_ list URL。 如 表单 无 效 , 则 显示 模板 以 及 相关 的 错误 信息 。 


编辑 courses 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 


path('<pk>/module/', 


Views .CourseModuleUpdateView.as view(), 
name=" course module update'), 
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在 courses/manage/ 模 板 目录 中 创建 新 目录 ， 并 将 其 命名 为 module。 创 建 courses/ 
manage/module/formset.html 模板 ， 并 向 其 添加 下 列 代 码 : 


{$$ extends "base-htm1l" $} 


[i 


{ 当 block title %} 
Edit "“{{ course.title }}" 
{$% endblock %} 


{% block content %} 
<hl>Edit "“{{ course.title }}"</hl> 
<div class="module"> 
<h2>Course modules</h2> 
<form action="" method="post"> 
{{ formset }} 
{{ formset.management form }} 
{$% csrf token %} 
<input type="submit" class="button" value="Save modules"> 
</form> 
</div> 
{% endblock %} 


在 该 模板 中 ， 我 们 创建 了 <form> HTML 元 素 ， 其 中 包含 了 formset。 除 此 之 外 ， 还 针 
对 包含 变量 { {formset.management form }} 的 表单 集 设置 了 管理 表单 。 其 中 ， 管 理 表单 涵 
盖 了 隐藏 字段 ， 并 控制 初始 、 全 部 、 最 小 和 最 大 表单 数量 ， 因 而 表单 集 的 创建 过 程 将 变 
得 十 分 简单 。 

编辑 courses/manage/course/list.html 模板 ， 并 在 课程 编辑 和 删除 链接 下 方 ， 针 对 
course_ module_ update URL 添加 下 列 链接 : 

<a href="{% url "course edit" course.id $}">Edit</a> 

<a href="{% Url "course delete" course.id %}">Delete</a> 


<a href="{% url "course module update" course.id %}">Edit 
modules</a> 


上 述 链接 用 于 编辑 课程 模块 。 在 浏览 器 中 打开 http://127.0.0.1:8000/course/mine/， 创 
建 一 门 课程 并 对 此 单 击 Edit modules 链接 ， 对 应 的 表单 集 如 图 10.9 所 示 。 

该 表单 集 针对 课程 中 的 每 个 Module 对 象 设置 了 一 个 表单 。 此 后 ， 由 于 针对 
ModuleFormSet 设 置 了 extra=2, 因而 将 显示 两 个 额外 的 空 表单 。 当 保存 该 表单 集 时 , Django 
将 添加 另 两 个 附加 空 字段 ， 并 添加 新 的 模块 。 
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Edit "Django course" 


Course modules 


Title: 


Description: 


Delete: 


Title: 


Description: 


Delete: 


图 10.9 
10.5.2 ”向 课程 模块 中 添加 内 容 


当前 ， 我 们 需要 一 种 方法 可 向 课程 模块 中 添加 内 容 。 目 前 包含 4 种 不 同 的 内 容 类 型 ， 
即 文本 、 视 频 、 图 像 和 文件 。 对 此 ， 可 考虑 生成 4 种 不 同 的 视图 以 创建 相关 内 容 ， 且 分 
别 对 应 于 每 个 模型 。 因 此 ， 我 们 将 采取 一 种 更 加 通用 的 方案 创建 视图 ， 进 而 可 处 理 内 容 
模型 中 对 象 的 创建 或 更 新 操作 。 
编辑 courses 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 
from django.forms.models import modelform factory 


from django.apps import apps 
from .models import Module, Content 


class ContentCreateUpdateView (TemplateResponseMixin, View): 
module = None 
model = None 
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obj = None 
template name = "courses/manage/content/form.htm1" 


def get model(self, model name): 
if model name in ["'text', "video', ‘image', "file']: 
return apps.get model (app label='courses', 
model name=model name) 
return None 


def get form(self, model, *args, **kwargs): 
Form = modelform factory (model, exclude=['owner', 
"order' 
"created' ， 
"updated']) 
return Form(*args, **kwargs) 


def dispatch (self, request, module id, model name, id=None): 
self.module = get object or 404 (Module, 
id=module id, 
Course owner=request.user) 
self.model = self.get model (model name) 
人 
self.obj = get object or 404(self.model, 
id=id, 
owner=request .user) 
return super(ContentCreateUpdateView, 
self) .dispatch (request, module id, model name, id) 


上 述 代码 展示 了 ContentCreateUpdateView 的 第 1 部 分 内 容 。 据 此 ， 可 创建 、 更 新 不 
同 模型 的 内 容 。 该 视图 定义 了 下 列 方法 。 


口 


口 


口 


get model0: 检查 模型 名 称 是 否 是 4 个 内 容 模型 名 称 之 一 , 即 Text、 Video、 Image 
或 File。 随 后 , 利用 Django 的 apps moudle 针对 给 定 的 模型 名 称 获取 实际 类 。 如 
果 给 定 的 模型 名 称 不 符 ， 该 方法 则 返回 None。 
get_form(): 利用 表单 框架 的 modelform factory0O 函 数 构建 动态 表单 。 考 虑 到 针 
对 Text、Video、Image 和 File 模块 构建 一 个 表单 ， 因 而 将 使 用 exclude 参数 来 
指定 要 从 表单 中 排除 的 公共 字段 ， 并 让 所 有 其 他 属性 自动 包含 进来 。 据 此 ， 根 
据 模型 的 不 同 ， 我 们 不 需要 知道 要 包括 哪些 字段 。 

dispatch(): 该 方法 接收 下 列 URL 参数 ， 并 作为 类 属性 存储 对 应 的 模块 、 模 型 和 
内 容 对 象 。 

> module id: 内 容 所 关联 的 模块 ID。 
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> model name: 要 创建 、 更 新 的 内 容 的 模型 名 称 。 
> id: 所 更 新 的 对 象 ID。 当 创建 新 对 象 时 ， 该 参数 设置 为 None。 
下 面向 ContentCreateUpdateView 添加 get0 和 post0 方 法 ， 如 下 所 示 : 


def get (self, request, module id, model name, id=None): 
form = self.get form(self.model, instance=self.obj) 

return self.render to response({'form': form, 
"object': self.obj}) 


def post (self, request, module id， model name, id=None): 
form = self.get form(self.model, 
instance=self.obj, 
data=request .POST, 
files=request .FILES) 


if form.is valid(): 
obj = form.save (commit=False) 
Obj.owner = request.user 
obj .save() 
if not id: 
# new content 
Content .objects.create (module=self .module, 
item=obj) 
return redirect('module content list', self.module.id) 
return self.render to response({'form': form, 
"object': self.obj}) 


上 述 方法 解释 如 下 。 

口 get(0: 当 接 收 GET 请 求 时 执行 该 方法 ， 并 针对 所 更 新 的 Text、Video 或 File 实 
例 构建 模型 表单 。 否 则 ， 将 不 传递 任何 实例 并 创建 新 对 象 一 一 如 果 未 提供 ID， 
self.obj 表示 为 None。 

口 ”post0: 当 接 收 POST 请 求 时 执行 该 方法 ， 向 其 传递 所 提交 的 数据 和 文件 以 构建 
模型 表单 ， 并 于 随后 对 此 进行 验证 。 如 果 表 单 有 效 ， 将 生成 新 对 象 ， 并 在 保存 
之 前 赋予 request.user 并 作为 其 持 有 者 。 接 下 来 将 检查 id 参数 : 如 果 未 提供 ID， 
则 知晓 当前 用 户 创 建 了 新 对 象 ， 而 非 更 新 现 有 对 象 。 针 对 新 对 象 ， 将 对 给 定 模 
块 创 建 一 个 Content 对 象 ， 并 将 新 内 容 与 其 关联 。 

编辑 courses 应 用 程序 的 urls py 文件， 并 向 其 中 添加 下 列 URL 路 径 : 


path('module/<int:module id>/content/<model name>/create/', 
Views.ContentCcreateUpdateView.as view(), 
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name='"module content create'), 


path('module/<int:module id>/content/<model name>/<id>/', 
views.ContentCreateUpdateView.as view(), 
name="'module content update'), 


新 的 URL 路 径 解 释 如 下 。 

口 module _content create: 创建 新 文本 、 视 频 、 图 像 或 文件 对 象 ， 并 将 其 添加 至 模 
块 中 。 其 中 涉及 module id 和 model name 参数 : 第 1 个 参数 可 将 新 内 容 对 象 链 
接 至 给 定 的 模块 ， 第 2 个 参数 则 指定 了 构建 表单 的 内 容 模型 。 

口 module content update: 更 新 现 有 的 文本 、 视 频 、 图 像 或 文件 对 象 。 其 中 涉及 
module id、model name、id 参数 ， 用 以 识别 所 更 新 的 内 容 。 

在 courses/manage/ 模 板 目 录 中 生成 新 的 目录 ， 并 将 其 命名 为 content。 创 建 courses/ 

manage/content/form.html 模板 ， 并 向 其 中 添加 下 列 代码 ; 


{s extends "base.htmlm $%} 


{% block title %} 
{% if object %} 
Edit content "{{f object.title }}" 
{ else %} 
Add a new content 
{g endif %} 
{S$ endblock %} 


{% block content %} 
<h1l> 
{% if object %} 
Edit content "{{ object.title }}" 
{S$ else $} 
Add a new content 
{$ endif %} 
</h1l> 
<div class="module"> 
<h2>Course info</h2> 
<form action="" method="post" enctype="multipart/form-data"> 
{{ form.as p }} 
{$$ csrf token $} 
<p><input type="submit" value="Save content"></p> 
</form> 
</div> 
{SS endblock %$} 


.354。 Django 项 目 实例 精 解 (第 2 版 


上 述 代码 定义 了 ContentCreateUpdateView 视图 模板 。 在 该 模板 中 ， 将 检查 object 变 
量 是 否 处 于 当前 上 下 文中 。 如 果 object 位 于 当前 上 下 文中 ， 则 更 新 现 有 对 象 ， 和 否则 将 创 
建新 对 象 。 
由 于 表单 包含 了 针对 File 和 Image 内 容 模 型 的 文件 上 传 ， 因 而 在 <form> HTML 元 素 
中 包含 了 enctype="multipart/form-data"。 

运行 开发 服务 器 ， 打 开 http://127.0.0.1:8000/course/mine/， 针 对 已 有 课程 单 击 Edit 
modules 按钮 并 创建 一 个 模块 。 利 用 python manage.py shell 命令 打开 Python Shell， 获 取 
最 近 生 成 的 模块 DD， 如 下 所 示 。 

>>> from courses.models import Module 


>>> Module.objects.latest('id') .id 
6 


运行 开发 服务 器 并 在 浏览 器 中 访问 http://127.0.0.1:8000/course/module/6/content/image/ 
create/， 通 过 之 前 获得 的 ID 蔡 换 现 有 模块 ID。 图 10.10 显示 了 创建 Image 对 象 的 表单 。 


Add a new content 


Course info 


Title: 


File: 


Choose File no file selected 


图 10.10 
当前 尚 不 可 提交 表单 ， 否 则 ， 鉴 于 尚未 定义 module content list URL， 因 而 将 会 出 现 
错误 。 稍 后 将 对 此 加 以 讨论 。 
除 此 之 外 ,还 需要 一 个 视图 并 对 相关 内 容 予 以 删除 .编辑 courses 应 用 程序 的 views.py 
文件 ， 并 向 其 中 添加 下 列 代码 : 
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class ContentDeleteView(View) : 


def post (self, request, id): 
content = get object or 404(Content, 
id=id, 
module course owner=request.user) 
module = content.module 


content.item.delete () 
content .delete () 
return redirect('module _ content list', module.id) 


ContentDeleteView 类 将 利用 给 定 的 ID 检索 Content 对 象 ;删除 所 关联 的 Text、Video、 
Image 或 File 对 象 ;最 后 将 删除 Content 对 象 ,并 将 用 户 重 定向 至 module_content list URL， 
进而 显示 该 模块 的 其 他 内 容 。 

编辑 courses 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL: 

path('content/<int:id>/delete/', 


views.ContentDeleteView.as view(), 
name="'module content delete'), 


至 此 ， 教 师 可 方便 地 对 相关 内 容 予以 创建 、 更 新 和 删除 。 
10.5.3 ”管理 模块 和 内 容 


前 述 内 容 构 建 了 相关 视图 ， 并 可 创建 、 编 辑 、 删 除 课程 模块 和 内 容 ， 相 应 地 ， 需 要 
-个 视图 以 显示 某 一 门 课程 的 全 部 模块 ， 并 针对 特定 模块 列 出 相关 内 容 。 
编辑 courses 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 
class ModuleContentListView (TemplateResponseMixin, View): 
template name = 'courses/manage/module/content list.html' 


def get(self, request, module id) : 
module = get object or 404 (Module, 
id=module id, 
course owner=request.user) 


return self.render to response({'module': module}) 


上 述 代码 定义 了 ModuleContentListView， 该 视图 利用 属于 当前 用 户 的 给 定 ID 获取 
Module 对 象 ， 并 通过 给 定 的 模块 显示 模板 。 
编辑 courses 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL: 
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path ('"module/<int:module id>/"， 
Views.ModuleContentListView.as view(), 
name="'module content list'), 


在 templates/courses/manage/module/ 目 录 中 创建 新 模板 ,将 其 命名 为 content list.html， 
并 添加 下 列 代码 : 


{$s% extends "base.html" %} 


{% block title %} 
Module {{ module.orderladd:1 }}: {{ module.title }} 
{%% endblock %$} 


{% block content $%} 
{g% with course=module .course %} 
<hl>Course "{{ course.title }}"</hl> 
<div class="contents"> 
<h3>Modules</h3> 
<ul id="modules"> 
{$$ for m in course.modules.all %} 
<1i data-id="{{ m.id }}" {% if m == module $} 
class="selected"{% endif %}> 
<a href="{% Url "module content list" m.id %}"> 
<span> 
Module <span class="order">{{ m.orderladd:1 }}</span> 
</span> 
<br> 
{{ m.title }} 
</a> 
</1i> 
{s empty %} 
<li>No modules yet.</1i> 
{$$ endfor 当 } 
</ul> 
<p><a href="{% Url "course module update" course.id %}"> 
Edit modules</a></p> 
</div> 
<div class="module"> 
<h2>Module {{ module.orderladd:1 }}: {{ module.title }}</h2> 
<h3>Module contents:</h3> 


<div id="module-contents"> 
{$s for content in module.contents.all $%} 
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<div data-id="{{ content.id > 
{S$ with item=content.item %} 
<p>{{ item }}</p> 
<a href="#">Edit</a> 
<form action="{$% url "module content delete" content.id $}" 
method="post"> 
<input type="submit" value="Delete"> 
{%$ csrf token $%} 
</form> 
{S$ endwith $%} 
</div> 
{$$ empty %} 
<p>This module has no contents yet.</p> 
{%S endfor %} 
</div> 
<h3>Add new content:</h3> 
<ul class="content-types"> 
<li><a href="{% Url "module content create" module.id "text" %}"> 


Text</a></1i> 
<li><a href="{% url "module content create" module.id "image" $%}"> 
Image</a></1i> 
<li><a href="{% Url "module content create" module.id "video" $%$}"> 
Video</a></1i> 
<1i><a href="{% Url "module content create" module.id "file" %}"> 
File</a></1i> 
</ul> 
</div> 


{S$ endwith %} 

{$$ endblock %$} 

上 述 模 板 针对 某 一 门 课程 显示 全 部 模块 ， 以 及 所 选 模 块 的 相关 内 容 。 此 处 将 遍历 课 
程 模块 并 在 一 个 侧 栏 中 对 其 予以 显示 。 随 后 ， 将 遍历 该 模块 的 对 应 内 容 ， 并 访问 
content.item 以 获取 所 关联 的 Text、Video、Image 或 File 对 象 。 除 此 之 外 ， 还 设置 了 一 个 
链接 进而 创建 新 的 文本 、 视 频 、 图 像 或 文件 内 容 。 

这 里 ， 我 们 希望 知道 每 个 item 对 象 是 哪 一 种 类 型 的 对 象 ， 即 Text、Video、Image 或 
File。 对 此 ， 需 要 使 用 到 模型 名 称 构建 URL 进而 编辑 对 象 。 除 此 之 外 ， 还 应 根据 内 容 类 
型 在 模板 中 显示 每 个 条 目 。 通 过 访问 对 象 的 _ meta 属性 ， 可 从 模型 的 Meta 类 中 针对 某 个 
对 象 获取 模型 。 无 论 如 何 ，Django 并 不 支持 以 下 画 线 开 始 的 、 模 板 中 的 变量 和 属性 的 访 
问 行为 。 针 对 于 此 ， 可 编写 自 定 义 模板 过 滤器 解决 这 一 问题 。 

在 courses 应 用 程序 目录 中 创建 下 列 文件 结构 : 
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templatetags/ 
Tnit” py 
course.py 


编辑 course.py 模块 ， 并 向 其 中 添加 下 列 代码 : 


from django import template 


register = template.Library() 


@register.filter 
def model name (obj): 
EE 
return obj. meta.model name 
except AttributeError: 
return None 
上 述 代码 定义 了 模板 过 滤器 ， 并 可 作为 objectmodel_ name 用 于 模板 中 ， 以 针对 
对 象 获得 模型 名 称 。 
编辑 templates/courses/manage/module/content_list.html 模板 ， 并 在 {% extends %} 模 板 
标签 下 方向 其 添加 下 列 代码 行 : 
{s% load course 要 } 
这 将 加 载 course 模板 标签 ， 随 后 查看 下 列 代码 行 : 
<p>{{ item }}</p> 
<a href="#">Edit</a> 
并 蔡 换 为 下 列 内 容 : 


<p>{{ item }} ({{ itemlmodel _ name }})</p> 
<a href="{% url "module content update" module.id item|model name item.id 


%}">Edit</a> 
下 面 将 显示 模板 中 的 条 目 模型 ， 使 用 模型 名 称 构建 链接 以 编辑 对 象 。 编 辑 courses/ 
manage/course/list.html 模板 ， 并 向 module_content list URL 添加 一 个 链接 ， 如 下 所 示 : 


<a href="{% url "course module update" course.id s}">Edit modules</a> 
{% if course.modules.count > 0 %} 
<a href="{% url "module content list" course.modules.first.id %}"> 


Manage contents</a> 
{% endif %} 


新 链接 使 得 用 户 可 访问 课程 第 1 个 模块 中 的 内 容 〈 若 存在 ) 。 
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式 


打开 http://127.0.0.1:8000/course/mine/， 针 对 某 一 门 课程 (至 少 包含 了 一 个 模块 ) 壬 
击 Manage contents 链接 ， 对 应 页 面 如 图 10.11 所 示 。 


Course "Django course" 


Modules Module 1: Introduction to Django 


vt Module contents: 
Introduction to Django 
This module has no contents yet 


Add new content 


图 10.11 
当 单 击 左 侧 栏 中 的 某 个 模块 时 ， 其 内 容 将 显示 于 页 面 的 主 区 域 中 。 同 时 ， 该 模板 还 
包含 了 多 个 链接 ， 并 针对 所 显示 的 模块 添加 新 的 文本 、 视 频 、 图 像 或 文件 内 容 。 对 此 ， 
可 向 模块 添加 一 组 不 同 的 内 容 类 型 , 并 查看 最 终结 果 。 对 应 内 容 将 显示 于 Module contents 
下 方 ， 如 图 10.12 所 示 。 


Course "Django course" 


Module 2: Configuring Django 


Module contents: 
ction to Django 
Setting up Django (text) 
MODULE2 
Configuring Django 


Example settings py (mage) 


Add new content: 


图 10.12 
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10.5.4 “对 模块 和 内 容重 排序 


我 们 需要 提供 一 种 简单 的 方式 ， 以 对 课程 模块 及 其 内 容 进行 重新 排序 。 对 此 ， 可 使 
JavaScript 的 拖 忠 微 件 ， 并 通过 拖 忠 的 方式 令 用 户 对 课程 模块 重新 排序 。 当 用 户 终止 某 
个 模块 的 拖 电 行 为 时 ， 将 发 送 异步 请 求 (AJAX) 并 存储 新 的 模块 顺序 。 

django-braces 是 一 个 第 三 方 模块 ， 其 中 包含 了 Django 通用 混合 类 集合 。 此 类 混合 类 
针对 基于 类 的 视图 提供 了 附加 功能 。 关 于 django-braces 提供 的 全 部 混合 类 列表 ， 读 者 可 
访问 https://django-braces.readthedocs.io/ 以 了 解 更 多 内 容 。 

此 处 将 使 用 到 下 列 django-braces 混合 类 。 

口 CsrfExemptMixin: 避免 检测 POST 请 求 中 的 CSRF 令 牌 ， 无 须 生 成 csrf token 

即 可 执行 AJAX POST 请 求 。 

口 ”JsonRequestResponseMixin: 将 请 求 数据 解析 为 SON, 并 将 响应 序列 化 为 JSON， 

同时 使 用 application/json 内 容 类 型 返回 HTTP 响应 。 

通过 下 列 命令 和 pip 安装 django-braces: 


pip install django-braces==1.13.0 


我 们 需要 使 用 到 一 个 视图 ， 并 接收 编码 于 JSON 中 的 模块 ID 的 最 新 顺序 。 对 此 ， 编 
辑 courses 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from braces.views import CsrfExemptMixin, JsonRequestResponseMixin 


class ModuleOrderView (CsrfExemptMixin, 
JsonRequestResponseMixin, 
View): 
def post(self, request): 
for id, order in self.request json.items(): 
Module.objects.filter (id=id, 
course owner=request.user) .update (order=order) 
return self.render json response({'saved': 'OK'}) 


上 述 代码 定义 了 ModuleOrderView 视图 。 
相应 地 ， 还 可 构建 类 似 的 视图 并 对 模块 的 内 容 进行 排序 。 对 此 ， 向 views.py 文件 中 
添加 下 列 代码 : 


class ContentOrderView (CsrfExemptMixin, 
JsonRequestResponseMixin, 
View): 
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def post (5eIf，Fequest) : 
for id, order in self.request json.items () : 
Content .objects.filter(id=id， 
module course owner=request.user) \ 
-update (order=order) 
return self.render json response({'saved': 'OK'}) 


下 面 编辑 courses 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL: 


path('module/order/', 
Views.ModuleorderView.as View()， 
name='module order'), 


path('content/order/', 
Views.ContentOrderView.as View() ， 
name='content_order')， 


最 后 ， 还 需要 实现 模板 中 的 拖 电 功 能 ， 对 此 将 使 用 jQuery UI 库 。jQuery UI 构建 于 
jQuery 之 上 ， 并 提供 了 一 组 界面 交互 、 效 果 和 微 件 集合 。 此 处 将 使 用 到 其 中 的 sortable 
元 素 。 首 先 ， 需 要 在 基 模 板 中 载 入 jQuery UI。 打 开 位 于 courses 应 用 程序 templates/ 目 录 
中 的 base.html 文件 ， 在 当前 脚本 下 方 添加 jQuery UI 以 加 载 jQuery， 如 下 所 示 : 


<script 
src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"> </sc 
ript> 

<script 
src="https://ajax.googleapis.com/ajax/libs/jqueryui/1.12.1/jquery-ui.min.js 
"></script> 


此 处 在 jQuery 框架 之 后 加 载 jQuery UI。 下 面 编辑 courses/manage/module/content_ 
list.html 模板 ， 并 在 模板 底部 添加 下 列 代码 : 


{gs block domready %$} 
$('#modules') .sortable({ 
stop: function (event，ui) { 
modules order = {}; 
$('#modules') .children() .each (function(){ 
// update the order field 
$ (this) .find('.order') .text ($ (this) .index() + 1); 
// associate the module's id with its order 
modules order[$ (this) .data('id')] = $ (this).index(); 
]) 
$.ajax({ 
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type: "POST'"'， 
url: "'{% url "module order™ $}', 
contentType: "application/jsony charset=utf-8', 
dataType: 'json', 
data: JSON.stringify (modules order) 


$('#module-contents') .sortable({ 
stop: function(event, ui) { 
contents order = {}; 
$('#module-contents') .children() .each (function(){ 
// associate the module's id with its order 
contents order[$ (this) .data('id')] = $ (this).index(); 
1); 


$.ajax({ 
type: "POST '， 
VEL MIS rl "econtent OFder 和 7 
contentType: 'application/json; charset=utf-8', 
dataType: 'json', 
data: JSON.stringify(contents order), 


各 

{ 当 endblock $} 

JavaScript 代码 位 于 {% block domready %} 块 中 ， 因 而 包含 于 jQuery 的 $(document). 
ready0 事 件 中 定义 于 base.html 模板 中 ) 。 这 将 确保 页 面 加 载 后 执行 JavaScript 代码 。 
这 里 针对 侧 栏 中 的 模块 列表 定义 了 一 个 sortable 元 素 , 并 对 模块 的 内 容 列 表 定 义 了 另 一 个 
不 同 的 元 素 。 二 者 以 类 似 的 方式 工作 。 在 该 代码 中 ， 将 执行 下 列 任务 : 

(1) 首先 针对 modules HTML 元 素 定义 了 一 个 sortable 元 素 。 注 意 ， 由 于 jQuery 针 
对 选择 器 使 用 了 CSS 标记 ， 因 而 此 处 使 用 #modules。 

(2) 针对 stop 函数 定义 一 个 函数 。 每 次 用 户 结束 元 素 排序 时 将 引发 该 事件 。 

(3) 创建 一 个 空 modules_order 目录 。 其 中 ， 字 典 的 键 表示 为 模块 的 ID， 对 应 值 则 
表示 为 针对 每 个 模块 的 所 设置 的 顺序 。 

(4) 遍历 fmodule 子 元 素 ， 针 对 每 个 模块 重新 计算 显示 顺序 并 获取 其 data-id 属性 ， 
其 中 包含 了 模块 的 ID。 我 们 添加 IDD 作为 modules_order 字典 的 键 ， 并 添加 模块 的 新 索引 
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作为 值 。 
(5) 向 content order URL 发 送 AJAX POST 请 求 ， 其 9 
的 序列 化 JSON 数据 。 对 应 的 ModuleOrderView 负责 更 新 模块 的 顺序 。 
F 行 排序 的 sortable 元 素 也 基本 相同 。 返 回 至 浏览 器 并 重新 加 载 页 面 ， 当 前 ， 
乒 、 拖 遇 操 作 ， 进 而 对 其 进行 重新 排序 ， 如 图 10.13 所 示 。 


对 内 容 进 
可 对 模块 和 内 


容 分 别 执行 单 各 


Course "Django course" 


Module 2: Configuring Django 


Modules 


Setting up Django (text) 


MODULE 
Edit Delete 


Configuring Django 
Example settings.py (image) 


Delete 


it 


Add new content 


图 10.13 
至 此 ， 我 们 对 课程 模块 和 模块 内 容 完成 了 重 排序 操作 。 
10.6 本 章 小 结 


本 章 讨论 了 如 何 创建 各 种 CMS， 其 中 使 用 了 模型 继承 机 制 ， 并 创建 了 自 定义 模型 字 


门 还 尝试 了 与 基于 类 的 视图 和 混合 类 协同 工作 。 最 后 ， 本 章 还 构建 了 表 自 


段 。 此 外 ， 我 人 
集 和 一 个 系统 ， 并 对 各 种 内 容 类 型 加 以 管理 
第 11 章 将 构建 一 个 学 生 注 册 系统 、 显 示 不 同类 型 的 内 容 ， 并 学 习 如 何 与 Django 


缓存 框架 协同 工作 。 


wp 
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第 10 章 使 用 了 模型 继承 机 制 以 及 通用 关系 创建 了 灵活 的 课程 内 容 模 型 。 除 此 之 外 ， 
还 通过 基于 类 的 视图 、 表 单 集 和 AJAX 内 容 排 序 机 制 构建 了 一 个 课程 管理 系统 。 本 章 了 
要 涉及 以 下 内 容 : 


mr 


利用 缓存 框架 对 内 容 进行 缓存 。 
面 首 先 创 建 学 生 课程 目录 ， 进 而 浏览 、 注 册 现 有 课程 。 


口 ”创建 公共 视图 以 显示 课程 信息 
口 ”构建 学 生 注册 系统 。 

口 管理 学 生 的 课程 注册 。 

口 显示 课程 内 容 。 

口 

下 


11.1 显示 课程 


对 于 课程 目录 ， 需 要 设置 下 列 功能 项 : 

口 “ 列 出 全 部 课程 ， 并 按照 科目 筛选 〈 可 选 ) 。 

口 显示 一 门 课程 的 概要 内 容 。 

编辑 courese 应 用 程序 的 views.py 文件 ， 并 添加 下 列 代码 : 


from django.db.models import Count 
from .models import Subject 


class CourseListView (TemplateResponseMixin, View): 
model = Course 
template name = 'courses/course/list.html' 


def get(self, request, subject=None): 
subjects = Subject.objects .annotate( 
total courses=Count('courses')) 
courses = Course.objects .annotate ( 
total modules=Count ('modules')) 
if subject: 
subject = get object or 404(Subject，slug=subject) 
Courses = courses.filter(subject=subject) 
return self.render to response({'subjects': subjects, 
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"subject': subject, 
"Courses': courses}) 
上 述 代码 定义 了 CourseListView 视图 ， 该 视图 继承 自 TemplateResponseMixin 和 
View。 在 该 视图 中 ， 将 执行 下 列 任务 : 
(1) 检索 全 部 科目 ， 包 括 每 种 科目 的 全 部 课程 数量 。 此 处 采用 了 ORM 的 annotate() 
方法 (基于 Count() 函 数 ) ， 并 针对 每 种 科目 计算 全 部 课程 数量 。 
(2) 检索 全 部 课程 ， 包 括 每 门 课程 中 所 包含 的 全 部 模块 数量 。 
(3) 如 果 给 定 某 个 科目 的 slug URL 参数 ， 将 检索 对 应 的 科目 对 象 ， 并 将 查询 操作 
限定 为 隶属 于 该 科目 的 课程 。 
(4) 使 用 TemplateResponseMixin 提供 的 render to_response() 方 法 ， 将 对 象 显示 于 模 
板 中 ， 并 返回 一 个 HITP 响应 。 
针对 单 门 课程 概要 内 容 的 显示 ， 下 面 创建 一 个 详细 视图 。 对 此 ， 可 向 views.py 文件 
中 添加 下 列 代码 : 


from django.views.generic.detail import DetailView 


class CourseDetailView (DetailView): 
model = Course 
template name = 'courses/course/detail.html' 


上 述 视 图 继承 自 Django 提供 的 通用 DetailView, 此 处 将 指定 model 和 template_name 
属性 。Django 的 DetailView 期 望 接收 主键 (pk) 或 slug URL 参数 ， 进 而 针对 给 定 模型 检 
索 单一 对 象 ， 随 后 将 显示 设置 于 template_name 中 的 模板 ， 包 括 上 下 文中 的 对 象 。 

编辑 educa 项 目的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 


from courses.views import CourseListView 


urlpatterns = [ 
0 
Path('', CourseListView.as view(), name='course list'), 


] 

由 于 需要 显示 URL http://127.0.0.1:8000/ 中 的 课程 列表 ， 因 而 需要 向 项 目的 urls.py 3 
文件 中 添加 course_list URL 路 径 ， 以 及 包含 /course/ 前 级 的 、courses 应 用 程序 的 所 有 其 人 
URL。 

编辑 courses 应 用 程序 的 urls.py 文件 ， 并 添加 下 列 URL 路 径 : 


path('subject/<slug:subject>)/"， 
Views.CourseListView.as view(), 


出 


这 
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name="'course list subject'), 


path('<slug:slug>/', 
Views.CourseDetailView.as View()， 
name="'course detail'), 

此 外 ， 我 们 还 定义 了 下 列 URL 路 径 。 

口 ”course list_subject: 显示 某 项 科目 的 全 部 课程 。 

口 ”course_detail; 显示 单 门 课程 的 概要 内 容 。 

下 面 针 对 CourseListView 和 CourseDetailView 视图 构建 模板 。 在 courses 应 用 程序 的 

templates/courses/ 目 录 中 生成 下 列 文件 结构 : 


course/ 
list.html 
detail.html 


编辑 courses/course/list.html 模板 ， 并 编写 下 列 代码 : 


{% extends "base.htmlm %} 


{% block title %} 
{% if subject %} 
{{ subject.title }} courses 
{$$ else $} 
All courses 
{$ endif %} 
{% endblock %} 


{% block content %} 
<h1> 
{% if subject %} 
{{ subject.title }} courses 
{ 当 else $} 
All courses 
{%S endif 要 } 
</h1> 
<div class="contents"> 
<h3>subjects</h3> 
<ul id="modules"> 
<li {% if not subject %}class="selected"{% endif %}> 
<a href="{% url "course list" $%}">All</a> 
</Li> 
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{g% for s in subjects %} 


<1li {% if subject == s $%}class="selected"{% endif $}> 
<a href="{%$ url "course list subject" s.slug $%$}"> 
tt stitle 3 


<br><span>{{ s.total courses }} courses</span> 


</a> 
</1i> 
{% endfor %} 
</ul> 
</div> 


<div class="module"> 
{$$ for course in courses %} 
{%s with subject=course.subject %} 
<h3><a href="{% url "course detail" course.slug %}"> 


{{ course.title }}</a></h3> 
<p> 
<a href="{% url "course list subject" subject.slug %}"> 
{{ subject }}</a>. 
{{ course.total modules }} modules. 
Instructor: {{ course.owner.get full name }} 
</p> 
{% endwith $%} 
{$$ endfor $%} 
</div> 
{ 当 endblock $} 


上 述 模板 将 列 出 当前 全 部 课程 。 我 们 创建 了 一 个 HTML 列表 显示 全 部 Subject 对 象 ， 
并 针对 每 个 对 象 建立 了 一 个 指向 course list_subject URL 的 链接 。 此 外 ， 还 添加 了 一 个 
selected HTML 类 ， 并 突出 显示 当前 科目 〈 若 存在 ) 。 最 后 ， 裔 历 每 个 Course 对 象 ， 并 
显示 模块 的 全 部 数量 以 教师 名 称 。 
运行 开发 服务 器 并 在 浏览 器 中 打开 http://127.0.0.1:8000/。 对 应 的 页 面 如 图 11.1 所 示 。 
其 中 ， 左 侧 栏 包含 了 全 部 科目 ， 以 及 每 项 科目 的 全 部 课程 数量 。 用 户 可 单 击 任意 科 
目 以 筛选 所 显示 的 课程 。 
编辑 courses/course/detail.html 模板 ， 并 向 其 中 添加 下 列 代 码 : 


{s extends "base-htmln $%} 


{ 当 block title %} 
{{ object.title }} 
{$$ endblock $} 
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并 选 


{$s block Content $} 
{$$ with subject=course.subject %} 
<h1> 
{{ object.title }} 
</h1> 
<div class="module"> 
<h2>0Overview</h2> 
<p> 
<a href="{% url "course list subject" subject.slug %}"> 
{{ subject.title }}</a>. 
{{ course.modules.count }} modules. 
Instructor: {{ course.owner.get full name }} 
</p> 
{{ object.overview|linebreaks }} 
</div> 
{$ endwith %} 
{ endblock %} 


All courses 


Subjects 


All 2 modules. Instructor Antonio Melé 


Mathematics 
1COURSES 2 modules. Instructor: Laura Marlon 


Music 

0 COURSES 

b 4 modules. Instructor Laura Marlon 
Physics 

0COURSES 


图 11.1 
上 述 模板 显示 了 某 一 门 课程 的 概述 和 详细 内 容 。 在 浏览 器 中 打开 http:/127.0.0.1:8000/ 
任意 一 门 课程 ， 对 应 的 页 面 内 容 如 图 11.2 所 示 。 
至 此 ， 我 们 创建 了 课程 显示 的 公共 区 域 。 除 此 之 外 ， 用 户 还 可 以 学 生 身 份 进行 注册 
区 相关 课程 。 
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Django course 


Overview 
Im 2 modules. Instructor Antonio Mele 


Meet Django. Django is a high-level Python Web framework that encourages rapid development and clean, 
pragmatic design. Built by experienced developers, it takes care of much of the hassle of Web development so you 
can focus on writing your app without needing to reinvent the wheel Its free and open source. 


图 11.2 
11.2 添加 学 生 注册 机 制 


利用 下 列 命令 创建 新 的 应 用 程序 : 
python manage.py startapp students 


编辑 educa 项 目的 settings.py 文件 ,并 向 INSTALLED_APPS 设置 中 添加 新 的 应 用 程 
序 ， 如 下 所 示 : 


INSTALLED APPS = [ 
着 
'students.apps.StudentsConfig', 


11.2.1 ”创建 学 生 注册 视图 


编辑 students 应 用 程序 的 views.py 文件 ， 并 编写 下 列 代 码 : 


from django.urls import reverse lazy 

from django.views.generic.edit import CreateView 

from django.contrib.auth.forms import UserCreationForm 
from django.contrib.auth import authenticate, login 


class StudentRegistrationView (CreateView): 
template name = 'students/student/registration.html' 
form class = UserCreationForm 
success url = reverse lazy(" student course list SA 
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def form valid(self, form): 
result = super(StudentRegistrationView, 
self) .form valid (form) 
cd = form.cleaned data 
user = authenticate (username=cd['username'], 
password=cd['password1']) 
login(self.request, user) 
return result 


上 述 视图 使 得 学 生 可 在 网 站 中 进行 注册 。 这 里 采用 了 通用 的 CreateView， 并 提供 了 
模型 对 象 的 创建 功能 。 该 视图 需要 使 用 到 下 列 属性 。 
口 template name: 显示 当前 视图 的 模板 路 径 。 
口 form class: 创建 对 象 的 表单 且 须 为 ModelFormm。 这 里 使 用 了 Django 的 
UserCreationForm 作为 注册 表单 ， 进 而 创建 User 对 象 。 
口 。success_url: 当 表 单 被 成 功 提交 后 ， 用 户 被 重 定向 的 URL。 我 们 逆 置 了 student_ 
course_list URL， 并 在 11.3 节 中 对 此 加 以 创建 ， 进 而 显示 学 生 所 注册 的 课程 。 
当 有 效 表单 数据 发 布 后 ，form_valid0 方 法 将 被 调用 ， 且 需要 返回 一 个 HTTP 响应 。 
我 们 重 载 了 该 方法 ， 并 在 用 户 成 功 注册 后 登录 。 
在 students 应 用 程序 目录 中 创建 新 的 文件 ， 将 其 命名 为 urls.py 并 添加 下 列 代码 : 


from django.urls import path 
from . import views 


urlpatterns = [ 
path('register/', 
Views .StudentRegistrationView.as View()， 
name="'student registration'), 


] 
随后 ,编辑 educa 项 目的 urls.py 文件 ， 并 针对 students 添加 URL， 即 向 URL 配置 中 
添加 下 列 路 径 : 


templates/ 
students/ 
student/ 
registration.html 


编辑 students/student/registration.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{%% extends "base.html™ %} 
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{% block title %} 
Sign up 
{$s endblock $} 


{$$ block content $%} 
<hl> 
Sign up 
</h1> 
<div class="module"> 
<p>Enter your details to create an account:</p> 
<form action="" method="post"> 
{{ form.as p }} 
{$$ csrf token $%} 
<p><input type="submit" value="Create my account"></p> 
</form> 
</div> 
{% endblock $} 


运行 开发 服务 器 , 并 在 浏览 器 中 打开 http://127.0.0.1:8000/students/register/， 对 应 的 注 
册 表 单 如 图 11.3 所 示 。 


Sign up 


Enter your details to create an account: 
Username; 


Password: 


Your password can't be too similar to your other personal information. 
Your password must contain at least 8 characters. 

Your password can't be a commonly used password. 

Your password can't be entirely numeric 


Password confirmation: 


图 11.3 
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需要 注意 的 是 ， 设 置 于 StudentRegistrationView 视图 的 success_url 属性 中 的 student 
course list URL 目前 尚 不 存在 。 如 提交 表单 ，Django 并 不 会 发 现 对 应 的 URL， 并 在 成 功 
注册 后 重 定向 用 户 。11.3 节 将 讨论 该 URL 的 创建 过 程 。 


11:2.2 


注册 课程 


待 用 户 账 号 创建 完毕 后 ， 即 可 注册 相关 课程 。 为 了 存储 注册 信息 ， 需 要 在 Course 和 
User 模型 间 创 建 多 对 多 关系 。 
编辑 courses 应 用 程序 的 models.py 文件 ， 并 向 Course 模型 中 添加 下 列 字段 


students = models.ManyToManyField (User, 


related name='courses joined', 
blank=True) 


在 Shell 中 ， 执 行 下 列 命令 并 针对 上 述 变 化 创建 迁移 ， 如 下 所 示 : 
python manage.py makemigrations 
对 应 输出 结果 如 下 所 示 : 


Migrations for 'courses': 
courses/migrations/0004 course students.py 


- RMdd field students to course 


随后 ， 执 行 下 列 命令 并 应 用 上 述 迁 移 : 


Python manage.py migrate 


对 应 输出 结果 如 下 所 示 : 


Applying courses.0004 course students... OK 


当前 ， 可 利用 所 选课 程 关联 学 生 对 象 。 下 面 对 此 创建 这 一 功能 ， 进 而 可 注册 课程 。 


在 students 应 用 程序 中 的 创建 新 文件 ， 将 其 命名 为 forms.py 并 添加 下 列 代码 : 


from django import forms 
from courses.models import Course 


class CourseEnrollForm(forms.Form): 


course = forms .ModelChoiceField(queryset=Course.objects.al1l()， 
widget=forms.HiddenInput) 


接 下 来 ， 将 面向 学 生 使 用 该 表单 并 注册 课程 。course 字段 对 应 于 学 生 所 注册 的 课程 ， 
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因而 表示 为 一 个 ModelChoiceField。 鉴于 并 不 打算 向 用 户 显示 这 一 字段 , 因而 此 处 使 用 了 
HiddenInput 微 件 。 相 应 地 ， 可 在 CourseDetailView 视图 中 使 用 该 表单 ， 并 显示 注册 按钮 。 
编辑 students 应 用 程序 的 views.py 文件 ， 并 添加 下 列 代码 : 


from django.views.generic.edit import FormView 
from django.contrib.auth.mixins import LoginRequiredMixin 
from .forms import CourseEnrollForm 


class StudentEnrollCourseView (LoginRequiredMixin, FormView): 
course = None 
form class = CourseEnrollForm 


def form valid(self, form): 
self.course = form.cleaned datal[l'course'] 
self.course.students.add (self.request .user) 
return super (StudentEnrollCourseView， 
self) .form valid (form) 


def get success url(self): 
return reverse lazy('student course detail', 
args=[self.course.id]) 

上 述 代 码 定 义 了 StudentEnrollCourseView 视图 ,并 处 理 在 courses 中 注册 的 学 生 对 象 。 
该 视图 继承 自 LoginRequiredMixin 混合 类 ， 因 此 ， 仅 登录 后 的 用 户 可 访问 该 视图 。 除 此 
之 外 , 考虑 到 还 需要 处 理 表单 提交 问题 ,因而 该 视图 还 继承 自 Django 的 FormView 视图 。 
对 于 form class 属性 ， 这 里 使 用 了 GoutseBhnzoll bor, 此 外 ， 对 于 给 定 的 Course 对 象 的 
存储 操作 ， 还 定义 了 一 个 course 属性 。 若 表单 有 效 ， 将 把 当前 用 户 添加 至 注册 课程 的 学 
生 对 象 中 。 

若 表单 被 成 功 提交 ，get_ success_url() 方 法 将 返回 用 定向 的 URL。 注 意 ， 该 方法 
等 价 于 success_url 属性 。 我 们 将 逆 置 student_course_detail URL(11.3 节 将 对 此 加 以 讨论 )， 
进而 显示 课程 内 容 。 

编辑 students 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 

path('enroll-course/', 


Views.StudentEnrollCourseView.as view(), 
name="'student enroll course'), 


下 面向 课程 概述 页 面 中 添加 注册 按钮 表单 。 对 此 ， 编 辑 courses 应 用 程序 的 views.py 
文件 ， 并 调整 CourseDetailView， 如 下 所 示 : 
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from students .forms import CourseEnrollForm 


class CourseDetailView (DetailView): 
model 


Course 


template name = 'courses/course/detail.html' 


def get context datal(self, **kwargs): 
context = super (CourseDetailView, 
self) .get context data(**kwargs) 
context['enroll form'] = CourseEnrollForm( 
initial={'course':self.object}) 
return context 


针对 模板 显示 问题 ,上 述 代 码 使 用 了 get_context Edam0 放 法 包 全 了 当前 上 下 文中 的 注 
册 表 单 。 我 们 使 用 当前 村 Course 对 象 初始 化 表单 的 隐藏 课程 字段 ， 以 便 直 接 提交 。 
编辑 courses/course/detail.html 模板 ， 并 查看 下 列 代码 行 ; 


{{ object.overview|linebreaks }} 
并 替换 为 下 列 内 容 : 
{{ object.overview|linebreaks }} 
{% if request.user.is authenticated %} 
<form action="{% url "student enroll course" %}" method="post"> 
{{ enroll form }} 
{% csrf token %} 
<input type="submit" class="button" value="Enroll now"> 
</form> 
{% else %} 
<a href="{% url "student registration" %}" class="button"> 
Register to enroll 
</a> 
{% endif %} 


上 述 代 码 用 于 注册 课程 。 对 于 验证 后 的 用 户 ， 将 显示 注册 按钮 ， 包 括 指向 student_ 
enroll_course URL 的 隐藏 表单 。 若 用 户 未 被 验证 ， 那 么 ， 将 仅 显 示 平台 注册 链接 。 

确保 开发 往 服务 器 处 于 运行 状态 。 在 浏览 器 中 打开 http://127.0.0.1:8000/， 并 单 击 雪 
一 门 课程 。 对 于 登录 用 户 ， 将 会 看 到 位 于 课程 概述 下 方 的 一 个 ENROLL NOW 按钮 ， 如 
图 11.4 所 示 。 

对 于 未 登录 用 户 ， 将 会 看 到 一 个 REGISTER TO ENROLL 按钮 。 
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Overview 


Programming. 2 modules. Instructor Antonio Melé 


Meet Django. Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic 
design. Built by experienced developers, it takes care of much of the hassle of Web development, so you can focus on 
writing your app without needing to reinvent the wheel. It's free and open source. 


图 11.4 


11.3 访问 课程 内 容 


考虑 到 
因而 可 编辑 students 应 用 程序 的 views.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


from django.views.generic.list import ListView 
from courses.models import Course 


class StudentCourseListView (LoginRequiredMixin, ListView): 
model = Course 
template name = 'students/course/list.html' 


def get queryset (self): 
qs = super (StudentCourseListView，self) .get queryset() 
return qs.filter(students in=[self.request.user]) 


上 述 视图 针对 学 生 对 象 而 定义 ， 并 列 出 了 其 所 注册 的 相关 课程 。 该 视图 继承 
LoginRequiredMixin， 以 确保 仅 登 录 后 的 用 户 可 访问 该 视图 。 此 外 ， 该 视图 还 继承 自 通 
ListView， 以 显示 Course 对 象 列 表 。 此 处 将 重 载 get_queryset0 方 法 ， 且 仅 检 索 用 户 注 
的 课程 。 对 此 ， 将 通过 学 生 的 ManyToManyField 字段 筛选 QuerySet。 

接 下 来 ， 向 views.py 文件 中 添加 下 列 代码 : 


from django.views.generic.detail import DetailView 


class StudentCourseDetailView (DetailView): 
model = Course 
template name = 'students/course/detail.html' 


需要 使 用 一 个 视图 显示 学 生 注 册 的 课程 ， 以 及 另 一 个 视图 以 访问 课程 内 容 ， 


| 


年 
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def get queryset (self): 
qs = super (StudentCourseDetailView，self) .get queryset () 
return qs.filter(students in=[self.request.user]) 


def get context datal(self, **kwargs): 
context = super(StudentCourseDetailView, 
Self) .get context data(**kwargs) 

# get course object 
course = self.get object() 
if "module id' in self.kwargs: 

# get current module 

context['module'] = course.modules.get( 

id=self.kwargs['module id']) 

由 志和 

# get first module 

context['module'] = course.modules.all() [0] 
return context 


上 述 代码 定义 了 StudentCourseDetailView。 其 中 重 载 了 get_queryset() 方 法 ， 并 将 基 
QuerySet 限定 为 用 户 注 册 的 课程 。 除 此 之 外 , 我们 还 重 载 了 get_context_data()， 若 给 定 了 
module id URL 参数 ,还 将 在 当前 上 下 文中 设置 课程 模块 。 否 则 ,将 设置 课程 的 第 一 个 模 
块 。 通 过 这 种 方式 ， 学 生 可 浏览 课程 中 的 模块 。 

编辑 students 应 用 程序 的 urls.py 文件 ， 并 向 其 中 添加 下 列 URL 路 径 : 
path('courses/', 


Views .StudentCourseListView.as view(), 
name='student course list'), 


path('course/<pk>/"', 
Views .StudentCourseDetailView.as view(), 
name='student course detail'), 


path('course/<pk>/<module id>/', 
views.StudentCourseDetailView.as view(), 
name="student course detail module'), 


在 students 应 用 程序 的 templates/students/ 目 录 中 生成 下 列 文件 结构 : 


course/ 
detail.html 
list.html 


编辑 students/course/list.html 模板 ， 并 向 其 中 添加 下 列 代 码 : 
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{$$ extends "base-htm1l" $} 
{%$ block title %}My courses{% endblock %} 


{$$ block content $%} 
<hl>My courses</h1> 


<div class="module"> 
{$$ for course in object list %} 
<div class="course-info"> 
<h3>{{ course.title }}</h3> 
<p><a href="{% url "student course detail" course.id $}"> 
Access contents</a></p> 
</div> 
{%$ empty %} 
<p> 
You are not enrolled in any courses yet. 
<a href="{% url "course list" $%}">Browse courses</a> 
to enroll in a course. 
</p> 
{$% endfor $%} 
</div> 
{S$ endblock %$} 


上 述 模板 显示 了 用 户 注 册 的 课程 。 需 要 注意 的 是 ， 当 新 用 户 在 当前 平台 上 成 功 注 册 
后 ， 需 要 重 定向 至 student_course_list URL 处 。 除 此 之 外 ， 当 登录 至 平台 后 ， 也 应 重 定向 
编辑 educa 项 目的 settings.py 文件 ， 并 向 其 中 添加 下 列 代 码 ， 


from django.urls import reverse lazy 
LOGIN _ REDIRECT URL = reverse lazy('student course list') 


如 果 请 求 中 未 包含 next 参数 ， 那 么 ， 在 成 功 登 录 后 ， 上 述 代码 表示 为 auth 模块 所 用 
的 、 将 用 户 重 定向 的 设置 位 置 。 在 成 功 登 录 后 ,学 生 将 被 重 定向 至 student course list URL， 
进而 查看 他 们 所 注册 的 课程 。 

编辑 students/course/detail.html 模板 ， 并 向 其 中 添加 下 列 代码 : 


{$$ extends "base.htm]l™ $%} 


{% block title %} 
{{ object.title }} 
{ 委 endblock $} 
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{$s block content $} 
<hl> 
{{ module.title }} 
</h1> 
<div class="contents"> 
<h3>Modules</h3> 
<ul id="modules"> 
{$$ for m in object.modules.all $%} 
<1i data-id="{{ m.id }}" {$% if m == module 
%S}class="selected" 
{% endif %}> 
<a href="{% Url "student course detail module" 
object.id m.id $%$}"> 
<span> 
Module <span class="order">{{ m.orderladd:1 }} 
</span> 
</span> 
<br> 
{{ m.title }} 
</a> 
< 
{$$ empty %} 
<li>No modules yet.</1i> 
{g endfor $} 
</ul> 
</div> 
<div class="module"> 
{s for content in module.contents.all %} 
{% with item=content.item %} 
<h2>{{ item.title }}</h2> 
{{ item.render }} 
{S$ endwith %} 
{% endfor 要 } 
</div> 
{$$ endblock %$} 


上 述 模板 针对 注册 后 的 学 生 ， 进 而 可 访问 注册 后 的 学 生 。 首 先 ， 我 们 构建 了 一 个 
HTML 列表 ， 其 中 包含 了 全 部 课程 模块 ， 并 突出 显示 当前 模块 。 随 后 ， 遍 历 对 其 模块 内 
容 ， 并 访问 每 项 内 容 条 目 ， 同 时 利用 { {item.render}} 对 其 加 以 显示 。 稍 后 将 向 内 容 模型 中 
添加 render( 方 法 ， 该 方法 用 于 显示 相关 内 容 。 


Ee 
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我 们 需要 提供 一 种 方式 显示 每 一 个 内 容 类 型 。 对 此 ， 编 辑 courses 应 用 程序 的 
models py 文件 ， 并 向 ItemBase 模型 中 添加 render0 方 法 ， 如 下 所 示 : 


from django.template.loader import render to string 
from django.utils.safestring import mark safe 


class ItemBase (models.Model): 
大 


def render(self): 
return render to string('courses/content/{}.html'.format( 
self. meta.model name), {'item': self}) 
上 述 方法 使 用 render to_string0 函 数 显 示 一 个 模板 ， 并 作为 字符 串 返 回 显示 后 的 内 
容 。 每 种 内 容 类 型 都 是 采用 在 内 容 模型 之 后 命名 的 模板 予以 显示 。 此 处 使 用 了 self._meta. 
model name， 并 通过 动态 方式 针对 每 项 内 容 生 成 相应 的 模板 。render() 方 法 针对 各 种 内 容 
的 显示 提供 了 一 个 公共 接口 。 
在 courses 应 用 程序 的 templates/courses/ 目 录 中 生成 下 列 文件 结构 : 
content/ 
text .html 
file.html 
image .html 
Video.html 
编辑 courses/content/text html 模板 并 编写 下 列 代码 : 


{{ item.content|linebreaks|safe }} 


编辑 courses/content/file.html 并 添加 下 列 内 容 : 

<p><a href="{{ item.file.url }}" class="button">Download file</a></p> 

编辑 courses/content/image.html 模板 并 编写 下 列 内 容 : 

<p><img src="{{ item.file.url }}"></p> 

为 了 使 利用 ImageField 和 FileField 上 传 的 文件 能 够 正常 工作 ， 需 要 对 当前 项 目 进行 
设置 ， 并 通过 开发 服务 器 服务 于 媒体 文件 。 对 此 ， 编 辑 项 目的 settings.py 文件 ， 并 向 其 中 
添加 下 列 代码 : 


MEDIA URL = "/media/" 
MEDIA ROOT = os.path.join (BASE DIR, 'media/') 
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需要 注意 的 是 ，MEDIA_URL 表示 为 基 URL， 并 服务 于 上 传 后 的 文件 ， 而 MEDIA_ 
ROOT 表示 为 本 地 路 径 且 当前 文件 位 于 其 中 。 
编辑 项 目的 urlspy 文件 ， 并 向 其 中 添加 下 列 导 入 语句 : 


from django.conf import settings 
from django.conf.urls.static import static 


随后 在 文件 结尾 处 编写 下 列 代码 行 : 


if settings.DEBUG: 
urlpatterns += static(settings.MEDIR URL, 
document root=settings.MEDIA ROOT) 


至 此 ,当前 项 目 可 上 传 和 服务 媒体 文件 。 Django 开发 服务 器 在 开发 期 间 (将 DEBUG 
设置 为 True) 服务 媒体 文件 。 注意， 开发 服务 器 并 不 适用 于 产品 应 用 环境 。 第 13 章 将 讨 
论 如 何 设置 产品 环境 。 

除 此 之 外 ， 还 需要 针对 Video 对 象 的 显示 创建 一 个 模板 。 对 于 嵌入 的 视频 内 容 ， 这 
里 将 使 用 django-embed-video。django-embed-video 是 一 个 第 三 方 Django 应 用 程序 ， 可 将 
来 自 YouTube 或 Vimeo 的 视频 嵌入 模板 中 。 也 就 是 说 , 通过 简单 地 提供 视频 的 公共 URL。 
利用 下 列 命令 安装 django-embed-video 包 : 


pip install django-embed-video==1.1.2 


编辑 项 目的 settings.py 文件 ,并 向 INSTALLED _APPS 设置 中 添加 当前 应 用 程序 ， 如 
下 所 示 : 
INSTALLED APPS = [ 
a 
'embed video', 
] 
读者 访问 https://django-embed-video.readthedocs.io/en/latest/， 以 查看 django-embed- 
Video 应 用 程序 的 文档 。 
编辑 courses/content/video.html 模板 并 编写 下 列 代码 : 
{$$ load embed Video tags %} 
{s Video item.url "small" %} 
运行 开发 服务 器 ， 并 在 浏览 器 中 访问 http://127.0.0.1:8000/course/mine/。 
利用 Instructors 分 组 中 的 用 户 访问 站 点 ， 并 向 某 一 门 课程 中 添加 多 项 内 容 。 当 包含 视频 
内 容 时 , 仅 复制 任意 YouTube URL 即 可 , 如 https://www.youtube.com/watch?v=bgV39DlImZ2U， 
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并 将 其 包含 值 表单 的 url 字段 中 。 

在 向 课程 中 添加 了 相关 内 容 后 ， 打 开 http:/127.0.0.1:8000/， 单 击 当 前 课程 ， 随 后 辣 
击 ENROLL NOW 按钮 ,该 门 课程 将 被 注册 , 同时 用 户 将 被 重 
URL。 图 11.5 显示 了 示例 课程 内 容 。 


似 


定 问 至 student course_detail 


Introduction to Django 


Modules Why Django? 


MODULE1 


Introduction to Django Meet Django. Django is a high-level Python Web framework that encourages rapid 


development and clean, pragmatic design. Built by experienced developers ,it takes 
care of much of the hassle of Web development, so you can focus on writing your 


MODULE2 
app without needing to reinvent the wheel. Its free and open source. 


Configuring Django 
MODULE3 Django video 
Your first Django project 


DjangoCon 2012 - Malcolm Tredinnick "The 
re jangoCon alcolm Tredinnick "The … @ + 


Django URLs 


In the background 


Set can be changed ul 


图 11.5 
至 此 ， 针 对 不 同 课程 内 容 的 显示 问题 ， 我 们 创建 了 一 个 公共 接口 。 


11.4 使 用 缓存 框架 


Web 应 用 程序 的 HTTP 请 求 通常 会 涉及 数据 库 访问 、 数 据 处 理 以 及 模板 显示 。 与 更 
态 站 点 服务 相 比 ， 处 理 过 程 的 代价 往往 较为 高 昂 。 

当 站 点 流量 逐渐 增加 时 ， 某 些 请 求 中 的 开销 可 能 非常 大 ， 这 也 是 缓存 的 用 武之 地 。 
通过 缓存 查询 、 计 算 结果 以 及 HTTP 请 求 中 的 显示 内 容 ， 可 以 在 后 续 操作 中 避免 开销 较 


大 的 操作 
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。 这 将 在 服务 器 端 转 换 为 较 短 的 响应 时 间 以 及 较 少 的 处 理 操作 。 


Django 设置 了 健壮 的 缓存 系统 ， 并 可 利用 不 同 的 粒度 级 别 缓存 数据 。 具 体 来 说 ， 可 


以 缓存 单 次 查询 、 特 定 视 图 的 输出 结果 、 部 分 所 显示 的 模板 内 容 ， 甚 至 是 全 部 站 点 。 数 
据 项 可 针对 某 一 默认 的 时 间 值 存储 于 缓存 系统 中 。 另 外 ， 还 可 针对 缓存 数据 指定 默认 的 
超时 时 间 。 

当 应 用 程序 获得 某 个 HTTP 请 求 时 ， 下 列 内 容 展 示 了 缓存 框架 的 一 般 应 用 方式 : 

(1) 尝试 获取 缓存 中 的 请 求 数据 。 

(2) 若 存在 ， 则 返回 缓存 数据 。 

(3) 否则 执行 下 列 任务 : 


@ 执行 查询 或 所 需 的 处 理 操作 ， 以 获取 对 应 数据 。 
@ 将 生成 的 数据 保存 至 缓存 中 。 
@ 返回 数据 。 


关于 


cache/。 
11.4.1 
Djan 


口 


口 
口 


口 
口 


@ 注意 


为 了 


11.4.2 


Django 缓存 的 详细 信息 , 读者 可 访问 https://docs.djangoproject.com/en/2.0/topics/ 


有 效 的 缓存 后 端 


go 包含 了 多 种 缓存 后 端 ， 具 体 如 下 。 

backends.memcached.MemcachedCache 或 backends.memcached.PyLibMCCache: 
即 Memcached 后 端 。Memcached 是 一 个 快速 的 、 高 效 的 、 基 于 内 存 的 缓存 服务 
器 。 后 端的 使 用 取决 于 用 户 所 选取 的 Memcached Python 绑 定 。 
backends.db.DatabaseCache: 使 用 数据 库 作为 缓存 系统 。 
backends.filebased.FileBasedCache: 使 用 文件 存储 系统 ， 并 作为 单独 的 文件 序列 
化 和 存储 每 个 缓存 值 。 

backends.locmem.LocMemCache: 本 地 内 存 缓存 后 端 ， 这 也 是 默认 的 缓存 后 端 。 
backends.dummy.DummyCache: 仅 用 于 开发 的 虚拟 缓存 后 端 ， 实 现 了 缓存 接口 ， 
但 实际 上 并 未 缓存 任何 事物 。 该 缓存 针对 每 个 线程 且 是 线程 安全 的 。 


获得 最 佳 性 能 ， 可 使 用 基于 内 存 的 缓存 后 端 ， 如 Memcached 后 端 。 


安装 Memcached 


下 面 


定量 的 RAM 空 


而 


将 安装 Memcached 后 端 。Memcached 运行 于 内 存 中 ， 并 占 
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间 。 当 所 占用 的 RAM 已 满 时 ，Memcached 将 移 除 早期 数据 ， 并 存储 新 数据 。 
读者 可 访问 https://memcached.org/downloads 并 下 载 Memcached。 在 Linux 环境 下 ， 
可 通过 下 列 命令 安装 Memcached: 


./configure && make && make test && sudo make install 

对 于 macOS X 环境 , 可 利用 brew install memcached 命令 并 根据 Homebrew 包 管 理 器 
安装 Memcached。 另 外 ， 读 者 可 访问 https://brew.sh/ 下 载 Homebrew。 

待 Memcached 安装 完毕 后 ， 打 开 Shell 并 利用 下 列 命令 启动 Memcached: 

memcached -1 127.0.0.1:11211 

默认 状态 下 ，Memcached 运行 于 11211 端口 上 。 但 是 ， 也 可 通过 -1 选项 自 定义 主机 
和 端口 。 关 于 Memcached 的 更 多 信息 ， 读 者 可 访问 https://memcached.org。 

在 Memcached 安装 完毕 后 ， 还 需要 安装 其 Python 绑 定 。 对 此 ， 可 使 用 下 列 命 


Pip install python-memcached==1.59 


11.4.3 ”缓存 设置 


Django 提供 了 下 列 缓 存 设置 项 。 

口 CACHES: 表示 为 一 个 字典 ， 其 中 包含 了 项 目的 全 部 有 效 缓存 。 

口 CACHE MIDDLEWARE ALIAS: 用 于 存储 的 缓存 别名 。 

口 ”CACHE MIDDLEWARE KEY PREFIX: 用 于 缓存 键 的 前 缀 。 如 果 在 多 个 站 点 
间 共 有 相同 的 缓存 ， 设 置 前 绥 可 避免 键 冲突 问题 。 

口 CACHE MIDDLEWARE SECONDS: 缓存 页 面 的 默认 秒 数 。 

通过 CACHES 设置 项 ， 可 配置 项 目的 缓存 系统 。 该 设置 项 表示 为 一 个 字典 ， 并 可 针 

对 多 项 缓存 进行 配置 。 包 含 于 CACHES 字典 中 的 每 项 缓存 可 指定 下 列 数据 。 

口 BACKEND: 所 用 的 缓存 后 端 。 

口 KEY_FUNCTION: 表示 为 一 个 字符 串 ， 包含 一 个 带 点 的 可 调用 路 径 ， 该 路 径 接 
收 前 缀 、 版 本 和 键 作 为 参数 ， 并 返回 一 个 最 终 的 缓存 键 。 

口 KEY PREFIX: 针对 全 部 缓存 键 的 字符 串 前 级 ， 以 避免 冲突 问题 。 

口 LOCATION: 表示 缓存 的 位 置 。 取 决 于 缓存 后 端 ， 该 项 可 定义 为 一 个 字典 、3 
机 和 端口 ， 或 者 是 一 个 内 存 后 端 名 称 。 

口 ”OPTIONS: 传递 至 缓存 后 端的 附加 参数 。 

口 TIMEOUT: 表示 存储 缓存 键 的 默认 超时 量 〈 以 秒 计 ) 。 默 认 状 态 下 为 300 秒 ， 


出 
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即 5 分 钟 。 若 该 项 设置 为 None， 则 缓存 键 将 不 会 过 期 。 
口 VERSION: 缓存 键 默认 的 版 本 号 ， 这 对 于 缓存 版 本 控制 来 说 十 分 有 


11.4.4 ”向 项 目 中 添加 Memcached 


下 面 针 对 当前 项 目 配置 缓存 。 对 此 ， 编 辑 educa 项 目的 settings.py 文件 ， 并 向 其 中 添 
加 下 列 代码 : 


CACHES = { 
'default': { 
'BACKEND': 'django.core.cache.backends .memcached.MemcachedCache', 


"TOCATION®S “127:0-0-T:L12110. 


此 处 将 使 用 到 MemcachedCache 后 端 ， 并 利用 address:port 标识 指定 其 位 置 。 如 果 包 
含 多 个 Memcached 实例 ， 可 使 用 一 个 LOCATION 列表 。 

为 了 实现 对 Memcached 的 监控 ,可 使 用 名 为 django-memcache-status 的 第 三 方 数据 包 。 
该 应 用 程序 对 于 管理 站 点 中 的 Memcached 实例 显示 相应 的 统计 数据 。 相 应 地 ， 可 通过 下 
列 命令 安装 django-memcache-status: 


pip install django-memcache-status==1.3 
编辑 settings.py 文件 ， 并 向 INSTALLED APPS 设置 项 中 添加 Imemcache_status'， 如 
下 所 示 : 
INSTALLED APPS = [ 
染 2 


'memcache_status', 


] 


确保 Memcached 处 于 运行 状态 。 在 另 一 个 Shell 窗口 中 启动 开发 服务 器 ， 并 在 浏览 
器 中 打开 http:/127.0.0.1:8000/admin/。 利 用 超级 用 户 身份 登录 当前 站 点 ， 如 图 11.6 所 示 。 


MEMCACHED: DEFAULT: 127.0.0.1:11211 (1) - 0% LOAD 


图 11.6 


11.6 显示 了 缓存 应 用 状态 。 当 单 击 图 框 上 方 标题 时 , 将 显示 Memcached 实例 的 详 
细 信 息 。 
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至 此 ， 我 们 针对 当前 项 目 设 置 了 Memcached， 并 可 对 其 进行 监控 。 下 面 开 始 对 数据 
进行 缓存 。 


11.4.5 ”缓存 级 别 


Django 以 粒度 升序 提供 了 下 列 缓存 级 别 。 

口 ”底层 缓存 API: 提供 了 最 小 粒度 的 缓存 ， 并 可 缓存 特定 的 查询 和 计算 。 
口 基于 每 个 视图 的 缓存 : 针对 单一 视图 提供 缓存 。 

口 模板 缓存 ， 可 缓存 模板 片段 。 

口 基于 每 个 站 点 的 缓存 ， 提 供 了 最 高 级 别 的 缓存 ， 并 可 缓存 整个 网 站 。 


@ 注意 : 
在 实现 缓存 之 前 应 考虑 相应 的 缓存 策略 。 首 先 需要 关注 代价 相对 高 昂 的 查询 或 计 
算 ， 它 们 不 是 按 每 个 用 户 计算 的 


11.4.6 ”使 用 底层 缓存 API 


底层 缓存 API 可 利用 任意 粒度 存储 缓存 中 的 对 象 ， 相 关 API 位 于 django.core.cache， 
其 导入 方式 如 下 所 示 : 

from django.core.cache import cache 

这 将 使 用 默认 的 缓存 ， 即 caches['default]。 另 外 ， 也 可 通过 其 别名 访问 特定 的 缓存 ， 
如 下 所 示 : 

from django.core.cache import caches 

my_cache = caches["' alias'] 

接 下 来 考察 缓存 API 的 工作 方式 。 利 用 python manage.py shell 命令 打开 Shell， 并 执 
行 下 列 代码 : 

>>> from django.core.cache import cache 

>>> cache.set('musician', 'Django Reinhardt', 20) 

此 处 将 访问 默认 的 缓存 后 端 ， 并 使 用 set(key,value,timeout) 存 储 'musician' 键 20 秒 ， 划 
中 包含 了 一 个 Django Reinhardt' 字 符 串 。 如 果 未 指定 超时 时 间 ，Django 将 使 用 CACHES 
设置 项 中 针对 缓存 后 端 指定 的 默认 超时 。 接 下 来 执行 下 列 代码 : 


>>> cache.get('musician') 
"Django Reinhardt' 
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随后 根据 当前 缓存 对 键 进行 检索 。 等 待 20 秒 后 将 执行 下 列 同一 代码 : 

>>> cache.get('musician') 

这 一 次 并 未 返回 任何 值 。musician' 缓 存 键 超时 ,鉴于 该 键 不 
方法 返回 None。 
Os. 

由 于 无 法 分 辨 实际 值 和 缓存 丢失 ， 因 此 ， 一 般 应 避免 在 缓存 键 中 存储 None 值 。 

下 面 利 用 下 列 命令 缓存 QuerySet: 

>>> from courses.models import Subject 

>>> subjects = Subject.objects.all() 

>>> cache.set('all subjects', subjects) 

接 下 来 执行 Subject 模型 上 的 QuerySet， 并 将 返回 的 对 象 存储 于 'all_subjects' 键 中 。 随 
后 可 检索 缓存 后 的 数据 ， 如 下 所 示 : 

>>> cache.get('all subjects') 

<QuerySet [<Subject: Mathematics>, <Subject: Music>, <Subject: Physics>, 

<Subject: Programming>]> 

下 一 步 将 缓存 视图 中 的 某 些 查 询 。 对 此 ， 编 辑 courses 应 用 程序 的 views.py 文件 ， 并 
添加 下 列 导入 语句 : 

from django.core.cache import cache 

在 CourseListView 的 get(0) 方 法 中 ， 查 看 下 列 代码 : 

subjects = Subject.objects.annotate( 

total courses=Count ('courses')) 

并 替换 为 下 列 内 容 : 

subjects = cache.get('all subjects') 

if not subjects: 

subjects = Subject.objects .annotate( 
total courses=Count('courses')) 

cache.set('all subjects', subjects) 

在 上 述 代 码 中 ， 我 们 尝试 利用 cache.get0 方 法 从 缓存 中 获取 all_students 键 。 如 果 未 
发 现 该 键 ， 则 返回 None〈 尚 未 缓存 ， 或 者 已 经 缓存 但 已 超时 ) ， 执 行 查 询 操作 并 检索 全 
部 Subject 对 象 及 其 课程 数量 ， 随 后 利用 cache.set0 缓 存 结果 。 

运行 开发 服务 器 并 在 浏览 器 中 打开 http://127.0.0.1:8000/。 当 执行 该 视图 时 ， 缓 存 键 


由 


位 于 缓存 中 , 因而 getO 
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不 存在 进而 执行 QuerySet。 在 浏览 器 中 打开 http:/127.0.0.1:8000/admin/， 并 进一步 丰富 
Memcached 统计 数据 。 图 11.7 显示 了 缓存 所 使 用 的 数据 。 


MEMCACHED: DEFAULT 127.0.0.1:11211 (1) - 0% LOAD 


MissRatio 38% Mmm 
AvgGETbyitem 1 
Avg GET by seconds/minutes ”0/0 
Detailed Statistics: 


Pid 12606 


0y 0d, Oh, 43m, 12s 


03/30/18 17:13:02 


1.4.20 


2.0.21-stable 


图 11.7 


考察 Curr Items 项 ， 此 处 应 为 1， 表 明 缓 存 中 当前 存储 了 一 个 数据 项 ，Get Hits 则 表 
示 成 功 的 get 命令 的 数量 ，Get Misses 表示 丢失 键 的 get 请 求 ， Miss Ratio 则 通过 Get Hits 
和 Miss Ratio 进行 计算 。 

返回 至 http://127.0.0.1:8000/， 并 多 次 重新 加 载 页 面 。 当 查看 缓存 统计 结果 时 ， 将 会 
看 到 多 次 读 取 操 作 〈 相 应 地 ，Get Hits 和 Cmd Get 将 增加 ) 。 

很 多 时 候 ， 用 户 希望 缓存 基于 动态 数据 的 相关 内 容 。 对 此 ， 需 要 构建 动态 键 ， 并 包 
含 全 部 所 需 信息 ， 进 而 唯一 地 标识 缓存 数据 。 对 此 ， 编 辑 courses 应 用 程序 的 views.py 文 
件 ， 并 修改 CourseListView 视图 ， 如 下 所 示 : 

class CourseListView (TemplateResponseMixin, View): 


model = Course 
template name = 'courses/course/list.html' 


def get (self, request, subject=None): 
subjects = cache.get ('all subjects') 
if not subjects: 
subjects = Subject.objects .annotate( 
total courses=Count('courses')) 
cache.set('all subjects', subjects) 
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all courses = Course.objects .annotate( 
total modules=Count('modules')) 
if subject: 
subject = get object or 404(Subject, slug=subject) 
key = 'subject {} courses'.format(subject.id) 
courses = cache.get (key) 
if not courses: 
Courses = all courses.filter(subject=subject) 
cache .set (key，courses) 
else: 
Courses = cache.get('all courses') 
if not courses: 
Courses = all courses 
cache.set('all courses', courses) 
return self.render to response({'subjects': subjects, 
'subject': subject, 
'Courses': courses}) 


在 该 示例 中 ， 我 们 缓存 了 全 部 课程 ， 以 及 通过 科目 所 筛选 的 课程 。 如 果 未 设 定 任何 
科目 ， 那 么 ， 将 使 用 all_courses 存储 全 部 课程 。 如 果 存 在 某 个 科目 ， 则 利用 'subject_{}_ 
courses'.format(subject.id) 动 态 地 构建 该 键 。 

需要 注意 的 是 ， 此 处 不 可 使 用 缓存 后 的 QuerySet 构建 其 他 QuerySet， 其 原因 在 于 ， 
缓存 的 内 容 实际 上 为 当前 QuerySet 的 结果 ， 因 而 无 法 执行 下 列 操作 : 

Courses = cache.get ('all courses') 

courses.filter (subject=subject) 

相反 ， 需 要 创建 其 QuerySet Course.objects.annotate(total modules=Count(modules))， 
且 需 要 对 其 进行 强制 执行 ， 同 时 利用 all_courses.filter(subject=subject) 进 一 步 限 制 
QuerySet， 以 防止 数据 未 存在 于 缓存 中 。 


11.4.7 ”缓存 模板 片段 


缓存 模板 片段 可 视 作 一 种 高 层 方案 ， 需 要 通过 {06 load cache %} 在 模板 中 加 载 缓存 标 


签 。 随 后 ， 可 使 用 {% cache %} 模 板 标签 缓存 特定 的 模板 片段 。 对 此 ， 一 般 采 用 下 列 模板 
标签 : 


{$$ cache 300 fragment name %} 


{$$ endcache $} 
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{% cache %} 标 签 包含 两 个 必需 的 参数 ， 即 超时 时 间 值 (以 秒 计 〉 以 及 片段 名 称 。 如 
果 需 要 根据 动态 数据 缓存 内 容 ， 还 可 传递 附加 参数 至 {% cache %} 模板 标签 中 ， 以 唯一 标 
识 当前 片段 。 

编辑 students 应 用 程序 的 /students/course/detail.html， 并 在 {% extends %} 标 签 后 添加 
下 列 代码 : 

{$$ load cache $} 

随后 查看 下 列 代码 行 : 


{$$ for content in module.contents.all %} 
{$$ with item=content.item %} 
<h2>{{ item.title }}</h2> 
{{ item.render }} 
{$$ endwith %} 
{% endfor %} 


并 替换 为 下 列 内 容 : 
{% cache 600 module contents module %} 
{% for content in module.contents.all %} 
{% with item=content.item %} 
<h2>{{ item.title }}</h2> 
{{ item.render }} 
{% endwith %} 
{S$ endfor %} 

{% endcache %} 

我 们 采用 名 称 module_contents 缓存 模板 片段 ， 并 向 其 中 传递 当前 的 Module 对 象 。 
因此 ， 可 唯一 标识 该 片段 。 注 意 ， 当 请 求 不 同 的 模块 时 ， 这 可 避免 缓存 某 个 模块 的 内 容 ， 
以 及 服务 于 错误 的 内 容 。 

人 @@ 注意 ， 

如 果 USE I18N 设置 为 True, 那么 , 每 个 站 点 中 间 件 缓存 将 遵循 处 于 活动 状态 下 的 
语言 。 如 果 使 用 {% cache 9%} 模 板 标签 ， 则 必须 使 用 模板 中 可 用 的 翻译 专用 变量 (之 一 ) 
来 实现 相同 的 结果 ， 如 {% cache 600 name requestLANGUAGE CODE %} 。 


11.4.8 缓存 视图 


利用 django.views.decorators.cache 中 的 cache page 装饰 器 ， 可 缓存 独立 视图 的 输出 
结果 。 其 中 ， 装 饰 器 需要 使 用 到 timeout 参数 〈 以 秒 计 ) 。 
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下 面 在 当前 视图 中 对 
添加 下 列 导 入 语句 : 


from django.views.decorators.cache import cache page 


加 以 应 用 。 对 此 ， 编 辑 students 应 用 程序 的 urls.py 文件 ， 并 


随后 ， 向 student_course_detail 和 student course_detail module URL 应 用 cache page 
装饰 器 ， 如 下 所 示 : 
path('course/<pk>/', 


cache page(60 * 15) (views.SstudentCourseDetailView.as view()), 
name="'student course detail'), 


path('course/<pk>/<module id>/', 
cache page(60 * 15) (views.SstudentCourseDetailView.as view()), 
name='student course detail module'), 


当前 ，StudentCourseDetailView 的 结果 将 缓存 15 分 钟 。 


人 注意， 


每 个 视图 缓存 使 用 URL 构建 缓存 键 。 指 向 同一 视图 的 多 个 URL 将 被 单独 缓存 


站 点 缓存 则 是 最 高 级 别 的 缓存 ， 进 而 可 缓存 整个 网 站 。 对 此 ， 可 编辑 项 目的 
settings.py 文件 ， 并 向 MIDDLEWARE 设置 中 添加 UpdateCacheMiddleware 和 
FetchFromCacheMiddleware 类 ， 如 下 所 示 : 


MIDDLEWARE = [ 
'django.middleware.security.SecurityMiddleware', 
'django.contrib.sessions.middleware.SessionMiddleware', 
"django .middleware.cache .UpdateCacheMiddleware', 
'django.middleware.common.CommonMiddleware', 

"django .middleware.cache.FetchFromCacheMiddleware', 
和 
] 


注意 ， 在 请 求 阶段 ， 中 间 件 将 以 既定 顺序 被 执行 ， 而 在 响应 阶段 则 以 逆序 执行 。 当 
中 间 件 以 逆序 执行 时 ， 考 虑 到 UpdateCacheMiddleware 运行 于 响应 期 内 ， 因 而 将 置 于 
CommonMiddleware 之 前 。FetchFromCacheMiddleware 则 置 于 CommonMiddleware 之 后 一 一 
需要 访问 后 者 所 设置 的 请 求 数据 。 

随后 ， 向 settings.py 文件 中 添加 下 列 设置 内 容 : 

CACHE MIDDLEWARE ALIAS = "default， 


CACHE MIDDLEWARE SECONDS = 60 * 15 # 15 minutes 
CACHE MIDDLEWARE KEY PREFIX = "educa'" 
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在 上 述 设置 中 , 针对 缓存 中 间 件 使 用 了 默认 缓存 , 并 将 全 局 缓存 超时 设置 为 15 分 钟 。 
此 外 , 还 对 所 有 缓存 键 指定 了 一 个 前 级 , 当 针 对 多 个 项 目 使 用 相同 的 Memcached 后 端 时 ， 
可 避免 出 现 键 冲突 问题 。 

据 此 ， 可 对 每 个 站 点 缓存 功能 进行 测试 。 当 前 ， 站 点 缓存 方案 并 不 适用 一 一 课程 管 
理 视 图 需要 显示 更 新 后 的 数据 ， 并 即刻 反映 这 一 变化 。 一 种 较 好 的 方案 是 缓存 用 于 向 学 
生 显 示 课 程 内 容 的 模板 或 视图 。 

至 此 ， 我们 已 经 了 解 了 Django 提供 的 缓存 数据 的 方法 。 读 者 可 视 具 体 情况 定义 缓存 

策略 ， 并 优先 考虑 代价 相对 高 昂 的 QuerySet 或 计算 行为 。 


11.5 本 章 小结 


本 章 创建 了 课程 公共 视图 , 以 及 学 生 课 程 注 册 系 统 。 此 外 , 本章 还 介绍 了 Memcached 
的 安装 过 程 ， 同 时 实现 了 不 同 的 缓存 级 别 。 
第 12 章 将 对 当前 项 目 构建 RESTful API。 


第 12 章 构建 API 


第 11 章 构 建 了 学 生 和 课程 注册 系统 , 并 创建 了 相关 视图 以 显示 课程 内 容 ; 除 此 之 外 ， 
我 们 还 学 习 了 使 用 Django 的 缓存 框架 。 本 章 主要 涉及 以 下 内 容 : 

口 ”构建 RESTful API。 

口 ”针对 API 视图 处 理 验证 和 授权 问题 。 

口 ”创建 API 视图 集 和 路 由 器 。 


12.1 构建 RESTful API 


用 户 可 能 需要 针对 其 他 服务 生成 一 个 接口 ， 进 而 与 Web 应 用 程序 进行 交互 。 通 过 构 
建 一 个 API， 第 三 方 即 可 使 用 相关 信息 ， 并 以 编程 方式 对 其 进行 操作 。 

针对 于 此 ， 存 在 多 种 方式 可 构建 API， 但 我 们 建议 遵循 REST 原则 。REST 是 表述 性 
状态 转移 〈Representational State Transfer) 的 简写 。RESTful API 是 基于 资源 的 ， 对 应 模 
型 即 体现 了 相关 资源 ， 诸 如 GET、POST、PUT 或 DELETE 这 一 类 方法 用 于 检索 、 创 建 、 
更 新 或 删除 对 象 。 另 外 , HTTP 响应 也 用 于 该 上 下 文中 。 不 同 的 HTTP 响应 代码 将 被 返回 ， 
并 以 此 表明 HTTP 响应 结果 ， 如 2XX 成 功 响应 代码 、4XX 错误 代码 等 。 

RESTful API 中 最 为 常见 的 数据 交换 格式 是 JSON 和 XML， 此 处 将 针对 项 目 利用 
JSON 序列 化 机 制 构建 REST API。 对 应 API 提供 了 下 列 功能 : 

口 检索 科目 。 

口 检索 有 效 课程 。 

口 检索 课程 内 容 。 

口 注册 一 门 课程 。 

通过 创建 自 定义 视图 ， 我 们 将 利用 Django 构建 一 个 API。 相 应 地 ， 存 在 多 种 第 三 方 
模块 可 对 项 目 生 成 API， 其 中 较为 流行 的 是 Django REST 框架 。 


12.1.1 安装 Django REST 框架 


Django REST 框架 可 针对 项 目 方便 地 构建 REST API。 读 者 可 访问 https:/www.django- 
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rest-framework.org/ 以 了 解 REST 框架 的 全 部 信息 。 
打开 Shell 并 利用 下 列 命 令 安装 框架 : 


pip install djangorestframework==3.8.2 


编辑 educa 项 目的 settings.py 文 件 ,向 INSTALLED APPS 设置 中 添加 rest_framework， 
以 激活 当前 应 用 程序 ， 如 下 所 示 : 
INSTALLED APPS = [ 
es 


'rest framework', 


] 
随后 向 settings.py 文件 中 添加 下 列 代码 : 
REST FRAMEWORK = { 
'DEFAULT PERMISSION CLASSES': 
'rest framework.permissions.DjangoModelPermissionsOrAnonReadOonly' 
] 
} 
通过 REST FRAMEWORK 设置 ， 可 向 API 提供 特定 的 配置 。 REST 框架 涵盖 了 范围 较 
广 的 设置 内 ， 进 而 可 配置 相关 的 默认 行为 。 DEFAULT_PERMISSION_CLASSES 设置 定义 了 
默认 权限 , 并 读 取 、 创 建 、 更 新 或 删除 对 象 。 这 里 将 DjangoModelPermissionsOrAnonReadOnly 
定义 为 唯一 的 默认 权限 类 ， 该 类 依赖 于 Django 的 授权 系统 ， 当 对 匿名 用 户 提供 只 读 访 问 
时 ， 可 使 用 户 创建 、 更 新 或 删除 对 象 。 稍 后 将 对 授权 机 制 进行 详细 讨论 。 
读者 可 访问 https:/www.django-rest-framework.org/api-guide/settings/， 并 查看 完整 的 
REST 框架 列表 。 


12.1.2 ”定义 序列 化 器 


待 REST 框架 设置 完毕 后 ， 还 需要 确定 数据 的 序列 化 方式 。 输 出 数据 应 以 特定 的 格 
式 进 行 序列 化 ; 而 输入 数据 则 需要 执行 反 序列 化 操作 。REST 框架 提供 了 下 列 类 ， 以 针对 
单一 对 象 构建 序列 化 器 。 

口 ”Serializer: 针对 常规 Python 类 提供 了 序列 化 行为 。 

口 ”ModelSerializer:， 针对 模型 实例 提供 了 序列 化 操作 。 

口 HyperlinkedModelSerializer: 等 同 于 ModelSerializer， 但 利用 链接 (而 非 主键 》 

体现 对 象 关系 。 
下 面 创建 第 一 个 序列 化 器 。 在 courses 应 用 程序 目录 内 生成 下 列 文件 结构 : 
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api/ 
Ly 
serializers.py 
我 们 将 在 api 目录 中 构建 所 有 的 API 功能 , 以 使 相关 内 容 处 于 良好 的 组 织 状 态 。 对 此 ， 
编辑 serializers.py 文件 ， 并 添加 下 列 代码 : 


from rest framework import serializers 
from ..models import Subject 


class SubjectSerializer(serializers.ModelSerializer): 

class Meta: 
model = Subject 
fields = ['id', 'title', 'slug'] 

上 述 代 码 表 示 为 Subject 模型 的 序列 化 器 。 序列 化 器 的 定义 方式 与 Django 的 Form 和 
ModelForm 类 相似 。Meta 类 负责 指定 实现 序列 化 的 模型 ， 以 及 设置 于 序列 化 中 的 字段 。 
如 果 未 设置 fields 属性 ， 那 么 ， 需 要 包含 全 部 模型 字段 。 

接 下 来 尝试 使 用 序列 化 器 。 打 开 命令 行 工具 ， 利 用 下 列 命令 启动 Django Shell: 

Python manage.py shell 

并 运行 下 列 代码 : 

>>> from courses.models import Subject 

>>> from courses.api.serializers import SubjectSerializer 

>>> subject = Subject.objects.latest('id') 

>>> serializer = SubjectSerializer (subject) 

>>> serializer.data 

{'id': 4, 'title': 'Programming', 'slug': 'programming'} 

在 该 示例 中 , 我 们 获得 Subject 对 象 、 创 建 SubjectSerializer 并 访问 序列 化 数据 。 不 难 
发 现 ， 该 模型 数据 已 转换 为 Python 本 地 数据 类 型 。 


12.1.3 理解 解析 器 和 泻 染 器 


序列 化 后 的 数据 必须 以 特定 的 格式 呈现 ， 然 后 才能 在 HITP 响应 中 返回 。 类 似 地 ， 
当 获取 某 个 HTTP 请 求 时 ， 需 要 解析 输入 数据 ， 并 在 对 其 进行 操作 前 执行 反 序列 化 操作 。 
REST 框架 内 置 了 泻 染 器 和 解析 器 对 此 进行 处 理 。 

下 面 考 察 如 何 解 析 输 入 数据 。 在 Python Shell 中 执行 下 列 代码 : 


>>> from io import BYytesIO 
>>> from rest framework.parsers import JSONParser 
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>>> data = b'{"id":4,"title":"Programming","slug":"programming"}' 
>>> JSONParser () .parse (BytesIO (data)) 


{'id': 4, 'title': 'Programming', 'slug': 'programming'} 
当 给 定 JSON 字符 串 格式 后 ， 可 使 用 REST 框架 提供 的 JSONParser 类 将 其 转换 为 
Python 对 象 。 


除 此 之 外 ，REST 框架 还 提供 了 Renderer 类 ， 并 可 格式 化 API 响应 结果 。 该 框架 通 
过 内 容 协 商 确定 使 用 哪个 泻 染 器 程序 , 并 期 望 接收 请 求 的 Accept 头 确定 响应 的 内 容 类 型 。 
一 种 可 选 的 方案 是 ， 演 染 器 可 通过 URL 的 格式 后 绥 确 定 。 例 如 ， 访 问 行为 将 触发 
JSONRenderer 以 返回 JSON 响应 。 

返回 至 Shell， 并 执行 下 列 代码 泻 染 前 述 序列 化 器 示例 中 的 serializer 对 象 : 

>>> from rest framework.renderers import JSONRenderer 

>>> JSONRenderer () .render (serializer.data) 

对 应 输出 结果 如 下 所 示 : 

b'{"id":4,"title":"Programming","slug":"programming"}' 


此 处 使 用 了 JSONRenderer 将 序列 化 数据 渲染 至 JSON。 默 认 状态 下 ，REST 框架 使 
用 不 同 的 泻 染 器 ， 即 JSONRenderer 和 BrowsableAPIRenderer。 其 中 ， 后 者 提供 了 一 个 
Web 接口 ， 从 而 可 方便 地 浏览 API。 相应 地 , 利用 REST FRAMEWORK 设置 的 DEFAULT 
RENDERER_CLASSES 选项 ， 还 可 修改 默认 的 泻 染 器 类 。 

关于 泻 染 器 和 解析 器 ， 读 者 可 分 别 访问 https://www.django-rest-framework.org/api- 
guide/renderers/ 和 https://www.django-rest-framework.org/api-guide/parsers/ 以 了 解 更 多 信息 。 


12.1.4 ”构建 列表 和 详细 视图 


REST 框架 包含 了 一 组 通用 视图 集合 混合 类 ， 并 以 此 构建 API 视图 ， 进而 可 检索 、 创 
建 、 更 新 、 删 除 模型 对 象 。 读 者 可 访问 https://www.django-rest-framework.org/api-guide/ 
generic-views/， 并 查看 全 部 通用 混合 类 和 视图 。 

下 面 创建 列表 和 详细 视图 并 检索 Subject 对 象 。 在 courses/api/ 目 录 中 生成 新 文件 ， 将 
其 命名 为 views.py， 并 向 其 中 添加 下 列 代码 : 

from rest framework import generics 


from ..models import Subject 
from .serializers import SubjectSerializer 


class SubjectListView (generics.ListAPIView): 
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queryset = Subject.objects.all () 
serializer class = SubjectSserializer 


class SubjectDetailView (generics.RetrieveAPIView): 
queryset = Subject.objects.all() 
serializer class = Subjectserializer 
上 述 代码 使 用 了 REST 框架 的 通用 ListAPIView 和 RetrieveAPIView 视图 。 针 对 详细 
视图 ， 这 里 包含 了 一 个 pk URL 参数 ， 并 针对 给 定 的 主键 检索 对 象 。 另 外 ， 两 个 视图 均 包 
含 下 列 属性 。 
口 ”queryset: 基 QuerySet， 用 以 检索 对 象 。 
口 serializer_class: 用 于 序列 化 对 象 的 类 。 
接 下 来 向 视图 中 加 入 URL 路 径 。 在 courses/api/ 目 录 中 生成 新 文件 ， 将 其 命名 为 
urls.py， 并 向 其 中 添加 下 列 代码 : 


from django.urls import path 
from . import views 


app name = 'courses' 


urlpatterns = [ 
path('subjects/', 
views.SubjectListView.as view()， 
name='subject list'), 


path('subjects/<pk>/', 
views.SubjectDetailView.as view(), 
name='subject detail'), 


] 
编辑 educa 项 目 中 的 urls.py 文件 ， 并 包含 API 路 径 ， 如 下 所 示 : 
urlpatterns = [ 
| 
path('api/', include('courses.api.urls', namespace='api')), 
] 
此 处 针对 API URL 使 用 了 api 命名 空间 。 同时 , 应 确保 利用 python manage.py runserver 
命令 使 服务 器 处 于 运行 状态 。 打 开 Shell， 利 用 curl 检索 URL http://127.0.0.1:8000/api/ 
subjects/， 如 下 所 示 : 


curl http://127.0.0.1:8000/api/subjects/ 
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对 应 的 响应 结果 如 下 所 示 : 


[ 
{"id":1,"title":"Mathematics","slug":"mathematics"}, 
Te i hs eT 
tid" :3 "title" "Physios" "sag”": "physica”}r 
{"id":4,"title":"Programming","slug":"programming"} 
] 


HTTP 响应 包含 了 一 个 JSON 格式 的 Subject 对 象 列表 。 如 果 读 者 的 操作 系统 中 尚未 
安装 curl， 可 访问 https://curl.haxx.se/dlwiz/ 予 以 下 载 。 除 了 curl 之 外 ， 还 可 通过 其 他 工具 
发 送 自 定义 HTTP 请求， 如 Postman 这 一 类 浏览 器 扩展 ， 读 者 可 访问 https://www- 
getpostman.com/ 进 行 下 载 。 

在 浏览 器 中 打开 http://127.0.0.1:8000/api/subjects/， 将 会 看 到 REST 框架 的 API， 如 
图 12.1 所 示 。 


Subiject List 


HTTP 200 OK 
Allow: GET, HEAD, OPTIONS 
Content-Type: application/json 
Vary: Accept 


": "Mathematics" 
"mathematics" 


": "programming” 
"programming™ 


图 12.1 
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这 表示 为 BrowsableAPIRenderer 提供 的 HTML 接口 ， 并 显示 了 执行 请 求 的 数据 头 和 
内 容 。 此 外 ， 还 可 在 URL 中 包含 ID， 进而 访问 Subject 对 象 的 API 详细 视图 。 在 浏览 器 中 
打开 http://127.0.0.1:8000/api/subjects/1/， 将 会 看 到 以 JSON 格式 显示 的 单一 Subject 对 象 。 


12.1.5” 藤 套 序列 化 器 


本 节 将 针对 Course 模型 创建 序列 化 器 .对 此 , 编辑 courses 应 用 程序 的 api/serializers.py 
文件 ， 并 向 其 中 添加 下 列 代码 : 


from ..models import Course 


class CourseSerializer (serializers.ModelSerializer): 
class Meta: 
model = Course 
fields = ['id', 'subject', 'title', 'slug', 'overview', 
'created', '‘'owner', 'modules'] 
下 面 考察 Course 对 象 的 序列 化 方式 。 打开 Shell, 执行 python manage.py shell 命令 并 
运行 下 列 代 码 : 
>>> from rest framework.renderers import JSONRenderer 
>>> from courses.models import Course 
>>> from courses.api.serializers import CourseSerializer 
>>> course = Course.objects.latest('id') 
>>> serializer = CourseSerializer (course) 
>>> JSONRenderer() .render (serializer.data) 
此 时 将 得 到 一 个 JSON 对 象 ， 其 中 包含 了 CourseSerializer 中 的 字段 。 可 以 看 到 ， 
modules 管理 器 的 关联 对 象 被 序列 化 为 一 个 主键 列表 ， 如 下 所 示 : 
"modules": [6, 7, 9, 10] 


我 们 需要 纳入 与 每 个 模块 相关 的 更 多 信息 ， 因 此 ， 需 要 序列 化 Module 对 象 并 对 其 进 
行 嵌 套 。 对 此 ， 可 修改 courses 应 用 程序 api/serializers.py 文件 中 的 代码 ， 如 下 所 示 : 


from rest framework import serializers 
from ..models import Module 


class ModuleSerializer(serializers.ModelSerializer): 
class Meta: 
model = Module 
fields = ['order', 'title', 'description'] 
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class CourseSerializer (serializers.ModelSerializer): 
modules = ModuleSerializer (many=True, read only=True) 


class Meta: 
model = Course 
fields = ["id", 'subject', 'title’', ‘'slug', “Overview' 
'created', ‘'owner', 'modules'] 

这 里 定义 了 ModuleSerializer， 并 针对 Module 模型 提供 了 序列 化 行为 。 随 后 ， 向 
CourseSerializer 添加 一 个 modules 属性 ， 并 嵌 套 ModuleSerializer 序列 化 器 。 另 外 ， 设 置 
many=True 并 以 此 表明 将 要 序列 化 多 个 对 象 。 同 时 ，read_only 参数 意味 着 ， 该 字段 具有 
只 读 属 性 ， 且 不 应 包含 至 任意 输入 内 容 中 以 创建 或 更 新 对 象 。 

打开 Shell 并 再 次 创建 CourseSerializer 实例 ， 并 利用 JSONRenderer 显示 序列 器 的 data 
属性 。 此 时 ， 所 列 模 块 的 序列 化 操作 将 采用 嵌 套 的 ModuleSerializer 序列 化 器 完成 ， 如 下 
所 示 : 

"modules": [ 

{ 


norder”:. OQ; 
"title": "Introduction to overview", 
"description": "A brief overview about the Web Framework." 


norder™: 1 
"title": "Configuring Django", 
"description": "How to install Django." 


1 


读者 可 访问 https://www.django-rest-framework.org/api-guide/serializers/， 以 了 解 与 序 
列 化 器 相关 的 更 多 内 容 。 


12.1.6 ”构建 自 定义 视图 


REST 框架 提供 了 APIView 类 , 并 在 Django 的 View 类 之 上 设置 API 功能 。 APIView 
类 不 同 于 View, 它 使 用 REST 框 架 的 自 定义 Request 和 Response 对 象 , 并 处 理 APIException 
异常 以 返回 适当 的 HTTP 响应 结果 。 除 此 之 外 ，APIView 类 还 内 置 了 授权 和 验证 系统 ， 
并 对 视图 的 访问 行为 进行 管理 。 
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下 面 创 建 一 个 用 户 视 图 用 于 注册 课程 。 编 辑 courses 应 用 程序 的 api/views.py 文件 ， 
并 向 其 中 添加 下 列 代码 : 


from django.shortcuts import get object or 404 
from rest framework.views import APIView 

from rest framework.response import Response 
from ..models import Course 


class CourseEnrollView (APIView): 
def post(self, request, pk, format=None): 
course = get object or 404(Course, pk=pk) 
course.students.add (request .user) 
return Response({'enrolled': True}) 
CourseEnrollView 视图 负责 处 理 用 户 的 课程 注册 操作 ， 如 下 所 示 : 
(1) 创建 一 个 自 定义 视图 ， 并 定义 为 APIView 的 子 类 。 
(2) 针对 POST 操作 定义 一 个 post0 方 法 ， 当 前 视图 不 支持 其 他 HTTP 方法 。 
(3) 期 望 接收 一 个 包含 课程 ID 的 pk URL 参数 。 根 据 给 定 的 pk 参数 检索 
不 存在 ， 则 抛 出 404 异常 。 
(4) 向 Course 对 象 的 students 多 对 多 关系 中 添加 当前 用 户 ， 并 返回 成 功 后 的 响应 


编辑 api/urls.py 文件 ， 针 对 CourseEnrollView 视图 添加 下 列 URL 路 径 : 
path('courses/<pk>/enroll/', 
Views.CourseEnrollView.as View()， 
name="'course enroll'), 
从 理论 上 讲 ， 当 前 可 执行 POST 请 求 ， 并 在 某 门 课程 中 注册 当前 用 户 。 但 是 ， 还 需 
要 对 用 户 进行 身份 验证 ， 以 防止 未 验证 用 户 访问 该 视图 。 下 面 考察 API 验证 和 授权 的 工 
作 方 式 。 


12.1.7 ”处理 授权 问题 


REST 框架 提供 了 验证 类 ， 并 对 执行 请 求 的 用 户 进行 验证 。 如 果 验 证 成 功 ， 该 框架 将 

在 request.user 中 设置 验证 后 的 User 对 象 ; 否则 , 将 设置 Django 的 AnonymousUser 实例 。 
REST 框架 提供 了 以 下 验证 后 端 。 

口 ”BasicAuthentication: 表示 为 基本 的 HTTP 验证 行为 ， 用 户 和 密码 由 客户 端 通过 

Base64 编码 的 授权 HTTP 报头 发 送 。 读 者 可 访问 https://en.wikipedia.org/wiki/ 
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Basic access authentication 以 了 解 更 多 信息 。 
口 TokenAuthentication: 基于 令 牌 的 验证 系统 。Token 模型 用 于 存储 用 户 的 令 牌 。 
户 包含 了 Authorization HTTP 验证 头 中 的 令 牌 。 
口 ”SessionAuthentication: 针对 验证 操作 ， 使 用 Django 的 会 话 后 端 。 该 后 端 可 对 站 
点 前 端的 API 执行 验证 后 的 AJAX 请 求 。 
口 “RemoteUserAuthentication: 将 验证 委托 至 Web 服务 器 上 ， 并 设置 REMOTE USER 
环境 变量 。 
通过 定义 REST 框架 提供 的 BaseAuthentication 类 的 子 类 , 并 
还 可 设置 自 定义 验证 后 端 。 
另外 ,还 可 针对 每 个 视图 设置 验证 机 制 , 或 者 通过 DEFAULT_AUTHENTICATION_ 
CLASSES 设置 项 采用 全 局 方式 对 其 进行 设置 。 


© 注意 ， 
关于 验证 机 制 的 全 部 内 容 ， 读 者 可 访问 https://www.django-rest-framework.org/api-guide/ 
authentication/ 


直 


重 载 authenticate() 方 法 ， 


接 下 来 向 视图 中 添加 BasicAuthentication。 对 此 , 编辑 courses 应 用 程序 的 apiviews.py 
文件 ， 并 向 CourseEnrollView 添加 authentication_classes 属性 ， 如 下 所 示 : 


from rest framework.authentication import BasicAuthentication 


class CourseEnrollView (APIView): 
authentication classes = (BasicAuthentication,) 


ee 
此 时 ， 用 户 将 通过 所 设置 的 凭证 (位 于 HITP 请 求 的 Authorization 头 中 ) 进行 验证 。 


12.1.8 ”向 视图 中 添加 授权 机 制 


REST 框架 中 包含 了 一 个 授权 系统 ， 进 而 限制 对 视图 的 访问 行为 。REST 框架 中 的 某 

些 内 置 授权 包括 以 下 方面 。 
口 AllowAny: 不 受 限制 的 访问 ， 无 论 用 户 是 否 被 验证 。 

口 IsAuthenticated: 仅 支 持 验证 用 户 的 访问 。 

口 IsAuthenticatedOrReadOnly: 对 已 验证 用 户 的 完整 访问 。 匿 名 用 户 仅 可 执行 读 取 
方法 ， 如 GET、HEAD 或 OPTIONS。 

口 DjangoModelPermissions: 与 django.contrib.auth 关联 的 权限 。 对 应 的 视图 需要 使 
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到 queryset 属性 。 仅 包含 模型 权限 的 验证 用 户 才 被 授予 权限 。 

口 “DjangoObjectPermissions: 在 每 个 对 象 上 的 Django 权限 。 

如 果 用 户 被 拒绝 ， 一 般 会 得 到 以 下 HTTP 错误 代码 。 

口 HTTP 404: 未 验证 。 

口 HTTP 403: 不 具备 相应 的 权限 。 

关于 权限 问题 ， 读 者 可 访问 https://www.django-rest-framework.org/api-guide/permissions/ 
以 了 解 更 多 内 容 。 

编辑 courses 应 用 程序 的 apiviews.py 文件 ， 并 向 CourseEnrollView 中 添加 一 个 
permission_classes 属性 ， 如 下 所 示 : 


from rest framework.authentication import BasicAuthentication 
from rest framework.permissions import IsAuthenticated 


class CourseEnrollView (APIView): 


authentication classes = (BasicAuthentication,) 
Permission classes = (IsAuthenticated,) 
ee 


此 处 设置 了 一 个 IsAuthenticated 权限 ,以 防止 匿名 用 户 访问 视图 。 下 面 针 对 新 的 API 
方法 执行 POST 请 求 。 

确保 开发 服务 器 处 于 运行 状态 。 打 开 Shell 并 运行 下 列 命令 : 

curl -i -X POST http://127.0.0.1:8000/api/courses/1/enroll/ 

对 应 的 响应 结果 如 下 所 示 : 


HTTP/1.1 401 Unauthorized 


{"detail": "Authentication credentials were not provided."} 


一 如 所 料 ， 此 处 将 生成 401 HTTP 代码 一 一 用 户 尚 未 被 验证 。 对 此 ， 可 通过 某 个 用 户 
执行 基本 的 验证 操作 ， 并 利用 现 有 用 户 的 凭证 替换 studentpassword， 如 下 所 示 : 


curl -i -X POST -u student:password 
http://127.0.0.1:8000/api/courses/1/enroll/ 


对 应 的 响应 结果 如 下 所 示 : 
HTTP/1.1 200 OK 
{"enrolled": true} 


相应 地 ， 可 访问 管理 站 点 ， 并 查看 用 户 的 课程 注册 状态 。 
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12.1.9 创建 视图 集合 路 由 器 


ViewSets 可 定义 API 的 交互 行为 ， 同 时 令 REST 框架 利用 Router 对 象 动态 地 构建 
URL。 通 过 视图 集 ， 可 避免 多 个 视图 间 的 重复 逻辑 现象 。 视 图 集 包 含 了 较为 常见 的 创建 、 
检索 、 更 新 、 删 除 操作 ， 即 list(、create()、retrieve()、update()、partial_ update()、destroy() 
方法 。 

下 面 针 对 Course 模型 创建 一 个 视图 集 。 编 辑 api/views.py 文件 ， 并 向 其 中 添加 下 列 
代码 : 


from rest framework import viewsets 
from .serializers import CourseSerializer 


class CourseViewSet (viewsets.ReadonlyModelViewset): 
queryset = Course.objects.all() 
serializer class = CourseSerializer 
这 里 定义 了 ReadOnlyModelViewSet 的 子 类 ， 并 针对 两 个 列表 对 象 提 供 了 只 读 操 作 
list0 和 retrieve()， 或 者 检索 单一 对 象 。 编 辑 api/urls.py 文件 ， 并 针对 视图 集 创建 一 个 路 由 
器 ， 如 下 所 示 : 
from django.urls import path, include 


from rest framework import routers 
from . import views 


router = routers.DefaultRouter () 
router.register('courses', views.CourseViewSet) 


urlpatterns = [ 
i 


path('', include (router.urls)), 

] 

上 述 代码 创建 了 DefaultRouter 对 象 ， 并 利用 courses 前 组 注册 当 
器 负责 针对 视图 集 自动 生成 URL。 

在 浏览 器 中 打开 http://127.0.0.1:8000/api/， 其 中 ， 路 由 器 在 其 基 URL 中 列 出 了 : 
视图 集 ， 如 图 12.2 所 示 。 

随后 可 访问 http://127.0.0.1:8000/api/courses/， 并 检索 课程 列表 。 

关于 视图 集 的 更 多 内 容 , 读者 可 访问 https://www.django-rest-framework.org/api-guide/ 
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viewsets/; 此 外 ， 读 者 还 可 访问 https://www.django-rest-framework.org/api-guide/routers/ 以 
查看 与 路 由 器 相关 的 更 多 信息 。 


The default basic root view for DefaultRouter 
GET /api 

HTTP 200 OK 

ALLow: GET, HEAD, OPTIONS 


Content-Type: application/json 
Vary: Accept 


"courses":; "http://127.0.0.1:8000/api/courses/" 


图 122 
12.1.10 ”向 视图 集 添加 附加 操作 


我 们 可 以 向 视图 集 添 加 额外 的 操作 。 相 应 地 ， 将 之 前 的 CourseEnrollView 视图 修改 为 
自 定义 视图 集 操作 。 对 此 ， 编 辑 api/views.py 文件 ， 并 调整 CourseViewSet 类 ， 如 下 所 示 : 


from rest framework.decorators import detail route 


class CourseViewSet (viewsets.ReadonlyModelViewset): 
queryset = Course.objects.all() 
serializer class = CourseSerializer 


@detail route (methods=['post'], 
authentication classes=[BasicAuthentication], 
Permission classes=[IsAuthenticated]) 
def enrolll(self, request, *args, **kwargs): 
course = self.get object() 
course.students .add (request .user) 
return Response ({'enrolled': True}) 


此 处 加 入 了 enroll0 方 法 ， 体 现 了 针对 视图 集 的 附加 操作 。 上 述 代 码 解 释 如 下 : 

(1) 使 用 detail route 装饰 器 ， 表 明 执 行 于 单一 对 象 上 的 操作 。 

(2) 装饰 器 针对 当前 操作 添加 了 自 定 义 属 性 。 我 们 指定 ， 仅 post 方 法 支持 当前 视图 
并 设置 验证 和 授权 类 。 
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(3) 使 用 selfget objectO 检 索 Courses 对 象 。 

(4) 向 students 多 对 多 关系 中 添加 当前 用 户 ， 并 返回 自 定义 响应 结果 。 
编辑 api/urls.py 文件 ， 并 移 除 下 列 URL: 
path('courses/<pk>/enroll1/', 


Views.CourseEnrollView.as view(), 
name="'course enroll'), 


五 


编辑 api/views.py 文件 ， 并 移 除 CourseEnrollView 类 。 
当前 ， 注 册 课 程 的 URL 可 通过 路 由 器 自动 生成 。 由 于 采用 了 名 为 enroll 的 操作 予以 
动态 构建 ， 因 而 该 URL 保持 不 变 。 


12.1.11 创建 自 定义 授权 


T 


学 生 应 能 够 访问 他 们 所 注册 的 相关 课程 ， 同 时 ， 仅 注册 了 课程 的 学 生 可 访问 其 中 的 内 
容 。 对 此 , 一 种 较 好 的 方式 是 使 用 自 定义 授权 类 。 相应 地 , Django 提供 了 一 个 BasePermission 
类 ， 并 可 定义 下 列 方法 。 
口 、has_permission(): 视图 级 别 的 授权 检测 。 
口 has_object_permission0: 实例 级 别 的 授权 检测 。 
这 些 方法 应 返回 True 并 授予 访问 权限 ， 否 则 返回 False。 在 courses/api/ 目 录 中 生成 新 
文件 ， 将 其 命名 为 permissions py， 并 向 其 中 添加 下 列 代码 ; 


from rest framework.permissions import BasePermission 


class IsEnrolled(BasePermission): 
def has object permission(self, request, view, obj): 
return obj.students.filter (id=request.user.id) .exists() 
此 处 定义 了 BasePermission 的 子 类 ， 并 重 载 了 has_object permission() 方 法 。 同 时 ， 
我 们 将 检测 执行 请 求 的 用 户 是 否 位 于 Courses 对 象 的 students 关系 中 ， 并 于 随后 使 用 
IsEnrolled 权限 。 


12.1.12 ”序列 化 课程 内 容 


本 节 将 讨论 课程 内 容 的 序列 化 操作 。Content 模型 包含 了 通用 外 键 ， 并 可 关联 不 同 内 
容 模型 的 对 象 。 在 第 11 章 中 ， 曾 针对 所 有 的 内 容 模型 加 入 了 公共 render() 方 法 。 我 们 可 
使 用 该 方法 向 API 提供 所 显示 的 内 容 。 

编辑 courses 应 用 程序 的 api/serializers py 文件 ， 并 向 其 中 添加 下 列 代码 
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from ..models import Content 


class ItemRelatedqField(serializers-RelatedqField) : 
def to representation(self, value): 
return value.render() 


class ContentSerializer (serializers.ModelSerializer): 
item = ItemRelatedField (read only=True) 


class Meta: 
model = Content 
fields = ['order', 'item'] 

上 述 代 码 设置 了 一 个 自 定义 字段 ， 即 REST 框架 提供 的 、RelatedField 序列 化 器 字段 的 
子 类 ， 并 重 载 了 to_representation() 方 法 。 此 外 ， 还 针对 Content 模型 定义 了 ContentSerializer 
序列 化 器 ， 并 针对 item 通用 外 键 使 用 了 自 定 义 字段 。 

对 于 包含 相关 内 容 的 Module 模型 ， 需 要 使 用 到 一 个 替代 的 序列 化 器 ， 以 及 一 个 扩展 
的 Course 序列 化 器 。 对 此 ， 编 辑 api/serializers.py 文件 ， 并 向 其 中 添加 下 列 代码 : 


class ModuleWithContentsSerializer (serializers.ModelSerializer): 
contents = ContentSerializer (many=True) 


class Meta: 
model = Module 
fields = ['order', 'title', 'description', 'contents'] 


class CourseWithContentsSerializer (serializers.ModelSerializer): 
modules = ModuleWithContentsSerializer (many=True) 


class Meta: 
model = Course 
fields = ['id', 'subject', 'title', 'slug', 
'OVverview', 'created', ‘'owner', 'modules'] 
下 面 创建 一 个 视图 ， 并 混合 retrieve0 的 行为 ， 但 包含 了 相应 的 课程 内 容 。 编 辑 
apij/views.py 文件 ， 并 向 CourseViewSet 类 中 添加 下 列 方法 。 


from .Permissions import IsEnrolled 
from .serializers import CourseWithContentsSerializer 


class CourseViewSet (viewsets.ReadonlyModelViewset): 


: 
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Qdetail_route (methods=['get']， 
serializer_class=CourseWithContentsSerializer， 
authentication classes=[BasicAuthentication], 
Permission classes=[IsAuthenticated, 

IsEnrolled]) 

def contents(self, request, *args, **kwargs): 

return self.retrieve(request, *args, **kwargs) 


该 方法 描述 如 下 : 


使 用 detail route 装饰 器 表明 当前 操作 执行 于 某 个 单一 对 象 上 。 

仅 GET 方法 支持 该 操作 。 

使 用 新 的 CourseWithContentsSerializer 序列 化 器 类 ， 并 包含 了 所 显示 的 课程 内 容 。 
使 用 IsAuthenticated 和 自 定义 IsEnrolled 权限 。 据 此 ， 可 确保 仅 注 册 了 课程 的 用 
户 可 访问 其 内 容 。 

使 用 现 有 的 retrieve0) 返 回 Course 对 象 。 


在 浏览 器 中 打开 http:/127.0.0.1:8000/api/courses/l/contents/， 若 采用 正确 的 凭证 内 容 
访问 视图 ， 将 会 看 到 ， 每 个 课程 模块 包含 了 针对 课程 内 容 所 显示 的 HTML， 如 下 所 示 : 


{ 


. 


"order": 0, 


"title": "Introduction to Django", 
"description": "Brief introduction to the Django Web Framework.", 
eontents™s 下 


{ 
norder™: 0 
"item": "<p>Meet Django. Django is a high-level 
Python Web framework 
ES 


"norder™: 1y 

"item": "\n<iframe width=\"480\" height=\"360\" 
src=\"http://www.youtube.com/embed/bgV39D1mZ2U? 
wmode=opaque\" 

frameborder=\"0\" allowfullscreen></iframe>\n" 


至 此 ， 我 们 构建 了 简单 的 API， 使 得 其 他 服务 可 通过 编程 方式 访问 课程 应 用 程序 。 
除 此 之 外 ，REST 框架 利用 ModelViewSet 视图 集 还 可 处 理 对 象 的 创建 和 编辑 操作 。 本 章 


介绍 了 REST 框架 的 主要 内 容 ， 读 者 还 可 访问 https://www.django-rest-framework.org/， 并 


查看 扩展 文档 中 的 


本 章 针对 其 他 


第 13 章 将 学 习 


义 中 间 件 ， 并 创建 


第 12 章 构建 API 


与 其 功能 相关 的 更 多 信息 。 
12.2 本 章 小 结 
民 务 创建 了 一 个 RESTful API， 进 而 可 与 Web 应 用 


自 定义 管理 命令 。 
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程序 进行 交互 。 


利用 uWSGI 和 NGINX 构建 产品 环境 。 此外, 还 将 讨论 如 何 实现 自 定 


第 13 章 部 署 项 目 


第 12 章 针对 项 目 创建 了 RESTful API。 本 章 将 学 习 如 何 生 成 项 目的 产品 环境 ， 并 涵 
盖 以 下 主题 

口 “配置 产品 环境 。 

口 ”创建 自 定义 中 间 件 。 

口 ”实现 自 定义 管理 命 


13.1 生成 产品 环境 


本 节 讨 论 如 何 将 Django 项 目 部 署 至 产品 环境 中 ， 并 遵循 下 列 各 项 步骤， 
(1) 针对 产品 环境 配置 设置 项 。 

(2) 采用 PostgreSQL 数据 库 。 

(3) 利用 uWSGI 和 NGINX 设置 Web 服务 器 。 

(4) 服务 静态 数据 集 。 

(5) 利用 SSL 实现 站 点 安全 措施 。 


13.1.1 针对 多 种 环境 管理 设置 内 容 


在 实际 项 目 中 ， 往 往 需 要 处 理 多 种 环境 ， 其 中 至 少 涉及 本 地 和 产品 环境 ， 但 同时 也 
会 包含 其 他 环境 ， 如 测试 或 前 期 生产 环境 。 某 些 项 目 设置 共用 于 全 部 环境 ， 而 其 他 一 些 
设置 则 需要 针对 每 种 环境 进行 调整 。 下 面 针对 多 种 环境 定义 项 目 设置 ， 同 时 使 其 处 于 有 
组 织 状 态 。 
在 educa 项 目的 settings.py 文件 旁边 创建 settings/ 目 录 ， 将 settings.py 文件 重 命名 为 
base.py 并 将 其 移 至 新 建 的 settings/ 目 录 中 。 在 setting/ 文 件 夹 中 生成 下 列 附 加 文件 ， 如 下 
所 示 : 
settings/ 
init .py 
base.py 
local.py 
pro-.py 


“412 。 Django 项 目 实例 精 解 〈 第 2 版 ) 


对 应 文件 解释 如 下 。 

口 ” 基 础 设置 文件 ， 包 含 了 公共 设置 内 容 〈 即 之 前 的 settings.py 文件) 。 
口 local py: 针对 本 地 环境 的 自 定 义 设置 。 

口 ”pro.py: 针对 商品 环境 的 自 定义 设置 。 

编辑 settings/base.py 文件 ， 并 查看 下 列 代码 行 : 


BASE DIR = os.path.dirname (os.path.dirname (os.path.abspath( file ))) 


并 替换 为 下 列 内 容 : 
BASE DIR = 


os.path.dirname (os.path.dirname (os.path.abspath(os.path.join( file ， 

os.pardir)))) 

我 们 已 经 将 设置 文件 移动 到 比 它 低 一 级 的 目录 中 ， 所 以 BASE_DIR 应 指向 父 目录 方 
可 保证 有 效 性 。 对 此 ， 可 利用 os.pardir 指向 父 目 录 。 

编辑 settings/local.py 文件 并 添加 下 列 代 码 行 : 


from .base import * 
DEBUG = True 


DATABASES = { 
"default': { 
'ENGINE': 'django.db.backends.sqlite3', 
'NAME': os.path.join (BASE DIR, 'db.sqlite3'), 


} 

上 述 代 码 表示 为 针对 本 地 环境 的 设置 文件 ， 其 中 导入 了 定义 于 base.py 文件 中 的 全 音 
设置 项 ， 同 时 仅 对 当前 环境 定义 了 特定 的 设置 内 容 。 此 外 ， 我 们 还 复制 了 base.py 文件 中 
的 DEBUG 和 DATABASES 设置 ， 此 类 设置 将 针对 每 种 环境 加 以 定义 。 此 时 ， 可 移 除 
base.py 文件 中 的 DATABASES 和 DEBUG 设置 。 

编辑 settings/pro.py 文件 ， 如 下 所 示 : 


from .base import * 


DEBUG = False 


ADMINS = ( 
('Antonio M', 'email@mydomain.com'), 
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) 
ALLOWED HOSTS = ['*'] 


DATABASES = { 
"default': { 
} 

上 述 代 码 表示 为 产品 环境 设置 ， 下 面 深入 考察 每 项 内 容 ， 具 体 如 下 。 

口 DEBUG: 将 DEBUG 设置 为 False 对 于 产品 环境 来 说 是 一 种 强制 行为 ， 否 则 ， 
将 导致 向 所 有 人 公开 回溯 信息 和 敏感 配置 数据 。 

口 ADMINS: 车 DEBUG 设置 为 False， 且 茶 个 视图 产生 异常 ， 全 部 信息 将 通过 电 
子 邮件 发 送 至 ADMINS 设置 中 的 相关 人 员 。 此 处 ， 应 确保 利用 个 人 信息 蔡 换 名 
称 / 电 子 邮 件 元 组 数据 。 

口 ALLOWED HOSTS: Django 仅 支 持 包含 于 当前 列表 中 的 主机 , 并 服务 于 应 用 程 
序 ， 这 可 视 作 一 种 安全 措施 。 这 里 ， 我 们 将 限制 用 于 应 用 程序 服务 的 主机 名 。 

口 DATABASES: 该 设置 项 暂时 为 空 ， 稍 后 将 介绍 用 于 生产 环境 的 数据 库 设置 。 


@ 注意 , 

当 处 理 多 种 环境 时 ， 须 创建 基础 文件 ， 以 及 针对 每 种 环境 的 设置 文件 。 其 中 ， 环 境 
设置 文件 应 继承 自 公共 设置 内 容 ， 并 重 载 特定 环境 下 的 设置 内 容 

我 们 已 经 将 项 目 设置 放置 在 与 默认 settings.py 文件 不 同 的 位 置 .除非 定义 了 所 用 的 设 
置 模块 ， 否 则 将 无 法 利用 manage.py 工具 执行 任何 命令 。 当 在 Shell 中 运行 管理 命令 ， 怠 
者 设置 一 个 DJIANGO_SETTINGS_MODULE 环境 变量 时 , 还 需要 添加 一 个 --settings 标记 。 

打开 Shell 并 运行 下 列 命令 : 


export DJANGO SETTINGS MODULE=educa.settings.pro 


该 语句 将 针对 当前 Shell 会 话 设置 DJANGO_SETTINGS_MODULE 环境 变量 。 如 果 
并 不 希望 针对 每 个 新 Shell 执行 该 命令 ,可 将 该 命令 添加 至 Shell 的 .bashrc 或 .bash_profile 
文件 配置 中 。 如 果 不 希 望 设置 该 变量 ， 则 需要 运行 管理 命令 ， 并 添加 --settings 标记 ， 如 
下 所 示 : 


Python manage.py migrate --settings=educa.settings.pro 


至 此 ， 我 们 已 经 成 功 地 针对 多 种 环境 组 织 了 相关 设置 内 容 。 
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13.1.2 使 用 PostgreSQL 


SQLite 数据 库 是 本 书 使 用 较 多 的 数据 库 。SQLite 相对 简单 并 可 实现 快速 安装 。 但 对 
于 生产 环境 ， 还 需要 使 用 到 更 为 强大 的 数据 库 产品 ， 如 PostgreSQL、MySQL 或 Oracle。 
第 3 章 曾 讨论 了 PostgreSQ 的 安装 和 设置 方式 。 

下 面 开 始 创建 PostgreSQ 用 户 。 对 此 ， 打 开 Shell 并 运行 下 列 命令 以 创建 一 个 数据 库 
用 方 : 

su postgres 

createuser -dP educa 


此 时 将 提示 输入 用 户 的 密码 和 权限 。 输 入 完毕 后 ， 可 利用 下 列 命 令 生成 新 的 数据 库 : 
createdb -E utf8 -U educa educa 
随后 可 编辑 settings/pro.py 文件 ， 并 修改 DATABASES 设置 ， 如 下 所 示 : 


DATABASES = { 
"default': { 
'ENGINE': 'django.db.backends.postgresql', 
'NAME': "educa' 
'USER': "educa' 
"PASSWORD" : '** 克 太太 


着 

利用 数据 库 名 和 所 创建 的 用 户 凭证 替换 上 述 数 据 。 新 数据 库 当 前 为 空 ， 运 行 下 列 命 
令 并 应 用 全 部 数据 库 迁 移 : 

Python manage.py migrate 

最 后 ， 利 用 下 列 命令 创建 超级 用 户 ; 


Python manage.py createsuperuseL 


13.1.3 ”项 目 检查 


Django 包含 了 check 管理 命令 , 并 可 随时 对 项 目 进行 检测 。 该 命令 接收 安装 于 Django 
中 的 应 用 程序 ， 并 输出 相关 错误 和 警告 信息 。 如 果 添 加 了 --deploy 选项 ， 则 仅 会 触发 与 产 
品 应 用 相关 的 额外 检测 。 打 开 Shell， 运 行 下 列 命 令 以 执行 检测 任务 : 


python manage.py check --deploy 


第 13 章 部 署 项 目 “415。 


输出 结果 包含 了 一 些 警告 信息 〈 不 存在 错误 消息 ) ， 这 意味 着 检测 成 功 ， 但 仍 需要 
查看 相应 的 警告 内 容 ， 确 保 项 目 出 于 产品 安全 状态 。 此 处 并 不 打算 对 此 加 以 深入 讨论 ， 
但 确实 应 在 应 用 产品 之 前 对 项 目 加 以 检测 ， 并 以 此 发 现 相关 问题 。 


13.1.4 通过 WSGI 为 Django 提供 服务 


WSGI 是 Django 的 主要 开发 平台 。WSGI 是 Web 服务 器 网 关 接 口 的 缩写 ， 并 可 对 
Web 上 的 Python 应 用 程序 提供 服务 。 

当 利用 startproject 命令 创建 新 项 目 时 , Django 在 项 目 目录 中 生成 wsgipy 文件 , 该 文 
件 包含 了 可 调用 的 WSGI 应 用 程序 ， 即 当前 应 用 程序 的 访问 点 。WSGI 可 在 Django 开发 
服务 器 上 运行 项 目 ， 以 及 在 产品 环境 中 所 选 服务 器 上 部 署 应 用 程序 。 

读者 可 访问 https://wsgi.readthedocs.io/en/latest/ 以 了 解 更 多 内 容 。 


13.1.5 安装 uWSGI 


本 书 采用 Django 开发 服务 器 运行 本 地 环境 。 但 是 , 我 们 需要 使 用 到 真实 的 Web 服务 
器 ， 并 在 产品 环境 中 部 署 应 用 程序 。 

uWSGI 是 一 类 快速 的 Python 服务 器 ， 通 过 WSGI 规范 与 Pythin 应 用 程序 进行 通信 。 
uWSGI 将 Web 请 求 转换 为 Django 项 目 可 处 理 的 格式 。 

我 们 可 通过 下 列 命令 安装 uWSGTI: 

pip install uwsgi==2.0.17 


当 构 建 uWSGI 时 ， 需 要 使 用 到 C 编译 器 ， 如 gcc 或 clang。 在 Linux 环境 下 ， 需 要 
通过 apt-get install build-essential 命令 进行 安装 。 

对 于 macOS X 环境 ， 可 通过 Homebrew 包 管 理 器 和 brew install uwsgi 命令 安装 
uWSGI。 如 果 需 要 在 Windows 上 安装 uwWSGI， 则 需要 使 用 到 Cygwin( 对 应 网 址 为 
https://www.cygwin.com) 。 然 而 ，UNIX 则 是 较为 理想 的 uwWSGI 应 用 环境 。 

读者 可 访问 https://uwsgi-docs.readthedocs.io/en/latest/， 并 查看 uWSGI 文档 。 


13.1.6 配置 uWSGI 


户 可 通过 命令 行 运行 WwWSGI。 打 开 Shell 并 在 educa 项 目 目录 中 运行 下 列 命令 : 


sudo uwsgi --module=educa.wsgi:application \ 
--env=DJANGO_ SETTINGS MODULE=educa.settings.pro \ 
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--master --pidfile=/tmp/project-master.pid \ 

--http=127.0.0.1:8000 \ 

--uid=1000 \ 

--virtualenv=/home/env/educa/ 

如 果 缺 少 所 需 权限 ， 则 需要 在 该 命令 前 添加 sudo。 

利用 这 一 命令 ， 可 通过 下 列 选项 在 本 地 主机 上 运行 WWSGI: 

口 ”使 用 可 调用 的 educa.wsgi:application WSGI。 

口 ”针对 产品 环境 加 载 当 前 设置 。 

口 ”使 用 虚拟 环境 。 利 用 实际 的 虚拟 环境 目录 葵 换 virtualenv 选项 中 的 路 径 。 如 果 未 

使 用 虚拟 环境 ， 则 可 忽略 该 选项 。 

如 果 未 在 项 目 目 录 中 运行 命令 ， 则 可 在 项 目 路 径 中 包含 选项 --chdir=/path/to/educa/。 

在 浏览 器 中 打开 http://127.0.0.1:8000/， 此 时 将 会 看 到 生成 的 HIML， 且 不 包含 CSS 
样式 表 或 所 加 载 的 图 像 。 考 虑 到 尚未 配置 uWSGI 来 为 静态 文件 服务 ， 因 而 这 一 结果 较为 
合理 。 


uWSGI 可 在 .ini 文件 中 设置 自 定义 配置 ， 与 通过 命令 行 传递 选项 相 比 ， 这 显得 更 加 


方便 。 
在 educa/ 目 录 中 生成 下 列 文件 结构 : 
config/ 
uwsgi.ini 
编辑 uwsgi.ini 文件 ， 并 向 其 中 添加 下 列 代码 : 
[uwsgi] 


# variables 

projectname = educa 

base = /home/projects/educa 

# configuration 

master = true 

virtualenv = /home/env/% (projectname) 
pythonpath = % (base) 

chdir = $ (base) 

env = DJANGO SETTINGS MODULE=% (projectname) .settings.pro 
module = educa.wsgi:application 
socket = /tmp/% (projectname) .sock 


在 .ini 文件 中 ， 我 们 定义 了 下 列 变量 。 
口 “projectname: 表示 为 Django 项目 名 ， 即 educa。 
口 base: educa 项 目的 绝对 路 径 。 可 利用 当前 项 目的 绝对 路 径 对 其 进行 替换 。 
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上 述 内 容 表 示 为 用 于 uWSGI 选项 中 的 自 定义 变量 。 只 要 名 称 与 WSGI 选项 不 同 ， 


户 可 


定义 任意 变量 。 


下 面 对 下 列 选项 进行 设置 。 
口 master: 启用 主 进程 。 


DOODD 


virtualenv: 虚拟 环境 路 径 。 可 利用 相关 路 径 对 其 加 以 替换 。 

pythonpath: 添加 至 Python 路 径 的 路 径 。 

chdir: 项 目 目录 路 径 ，uWSGI 在 加 载 应 用 程序 前 将 修改 为 该 目录 。 

env: 环境 变量 。 此 处 包含 了 指向 产品 环境 设置 的 DJANGO_SETTINGS_ MODULE 


口 module: 所 用 的 WSGI 模块 。 这 里 将 其 设置 为 包含 于 项 目 wsgi 模块 中 的 、 可 调 


用 的 application 。 


口 。 socket: 表示 为 绑 定 服务 器 的 UNIX/TCP 套 接 字 。 

socket 选项 用 于 与 某 些 第 三 方 路 由 器 进行 通信 ， 如 NGINX; 而 http 选项 则 用 于 
uWSGI, 接收 输入 的 HTTP 请 求 并 实现 自身 的 路 由 。 鉴 于 把 NGINX 配置 为 Web 服务 器 ， 
因而 这 里 将 通过 一 个 套 接 字 运行 WSGI， 并 通过 套 接 字 与 WSGI 进行 通信 。 

关于 uWSGI 的 选项 列表 ， 读 者 可 访问 https://uwsgi-docs.readthedocs.io/en/latest/ 


Option 


s.html 以 了 解 更 多 内 容 。 


接 下 来 ， 可 利用 下 列 命令 并 参照 自 定义 配置 运行 WWSGI: 


uwsgi --ini config/uwsgi.ini 


E 
13.1 


SI 


前 尚 无 法 访问 uWSGI 实例 一 一 该 实例 通过 套 接 字 运行 。 下 面 将 进一步 完善 产品 环境 。 


.7 安装 NGINX 


当 向 某 个 站 点 提供 服务 时 , 除了 动态 内 容 之 外 , 还 应 涵盖 静态 文件 , 如 CSS、JavaScript 


文件 和 图 像 。 虽 然 wWSGI 适用 于 静态 文件 ， 但 却 向 HITP 请 求 中 加 入 了 不 必要 的 开销 ， 


因此 ， 


建议 首先 设置 一 个 Web 服务 器 ， 如 NGINX。 


通常 ， 可 使 用 Web 服务 器 〈 如 前 面 的 NGINX) 高 效 、 快 速 地 提供 静态 文件 ， 并 将 
动态 请 求 转发 给 uWSGI worker。 通 过 使 用 NGINX， 还 可 以 应 用 相关 规则 ， 并 受益 于 它 
的 反 向 代理 功能 。 

利用 下 列 命令 安装 NGINX: 


sudo apt-get install nginx 


对 


于 macOS X 环境 , 可 通过 brew install nginx 命令 安装 NGINX。 读 者 可 访问 https://nginx. 
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org/en/download html， 其 中 包含 了 Windows 环境 下 的 NGINX 二 进 制 文件 。 


13.1.8 ”产品 环境 


图 13.1 展示 了 产品 环境 的 最 终 效果 。 


Socket 
Client 
browser 


Django 


图 13.1 
当 客 户 端 浏览 器 发 送 HTTP 请 求 时 ， 即 会 产生 下 列 行为 : 
(1) NGINX 接收 HTTP 请 求 。 
(2) 若 请 求 静态 文件 ，NGINX 将 直接 服务 于 静态 文件 。 若 请 求 动态 页 面 ，NGINX 
将 通过 套 接 字 将 请 求 委托 至 wWSGI。 
(3) UWSGI 将 请 求 传递 至 Django 以 用 于 处 理 。 最 终 的 HITP 响应 将 传 回 至 NGINX， 
并 依次 返回 至 客户 端 浏览 器 。 


13.1.9 配置 NGINX 


在 config/ 目 录 中 生成 新 文件 ， 将 其 命名 为 nginx.conf， 并 向 其 中 添加 下 列 代码 : 


# the upstream component nginx needs to connect to 
upstream educa { 
server unix:///tmp/educa.sock; 


} 
server { 
listen 80; 
server name www.educaproject.com educaproject.com; 
location / { 
include /etc/nginx/uwsgi params; 
uwsgi pass educa; 
} 
} 


上 述 代码 表示 为 NGINX 的 基本 配置 信息 ， 其 中 设置 了 名 为 educa 的 上 层 内 容 ， 并 指 
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向 WSGI 创建 的 套 接 字 。 这 里 使 用 了 服务 器 指令 并 添加 以 下 配置 : 
口 通知 NGINX 并 监听 80 端 
口 针对 www.educaproject.com 和 educaproject.com 设置 服务 器 名 称 。NGINX 分 别 
针对 两 个 域名 向 输入 请 求 通过 服务 。 
口 ” 我 们 指定 /路 径 下 的 所 有 内 容 都 必须 路 由 至 educa 套 接 字 (uWSGI) 。 此 外 ， 还 
包括 NGINX 自 带 的 默认 uWSGI 配置 参数 。 
读者 可 访问 https://nginx.org/en/docs/ 以 查看 NGINX 文档 。 
NGINX 主 配 置 文件 位 于 /etc/nginx/nginx.conf， 其 中 包含 了 /etc/nginx/sites-enabled/ 下 的 任 
意 配置 文件 。 为 了 使 NGINX 可 加 载 自 定义 配置 文件 ， 可 打开 Shell 并 创建 下 列 符号 链接 : 
sudo ln -s /home/projects/educa/config/nginx.conf /etc/nginx/site-senabled/ 
educa.conf 
相应 地 ， 利 用 项 目的 绝对 路 径 蔡 换 /home/projects/educa/。 随 后 ， 打 开 Shell 并 运行 
uUWSGI ( 若 尚未 处 于 运行 状态 ) : 
uwsgi --ini config/uwsgi.ini 


打开 第 二 个 Shell， 并 利用 下 列 命令 运行 NGINX: 

service nginx start 

鉴于 使 用 了 示例 域名 ， 因 而 需要 将 其 重 定向 至 本 地 主机 上 。 对 此 ， 编 辑 /etc/hosts 文 
并 向 其 中 添加 下 列 代码 行 : 


127.0.0.1 educaproject .com 
127.0.0.1 www.educaproject .com 


据 此 ， 可 将 两 个 主机 名 路 由 至 本 地 服务 器 上 。 在 产品 服务 器 上 ， 则 无 须 执 行 此 类 操作 ， 
其 原因 在 于 ， 须 持 有 一 个 固定 的 他 地址， 并 将 主机 名 指向 域名 DNS 配置 中 的 服务 器 上 。 
在 浏览 器 中 打开 http://educaproject.com/， 可 以 看 到 ， 当 前 站 点 尚未 加 载 任何 静态 数 
据 集 ， 但 产品 环境 已 经 准备 就 绪 。 
当前 ， 我 们 可 限制 向 Django 项 目 提 供 服务 的 主机 。 编 辑 项 目的 产品 设置 文件 
settings/pro.py， 并 修改 ALLOWED HOSTS 设置 ， 如 下 所 示 : 
ALLOWED HOSTS = ['educaproject.com', 'www.educaproject.com'] 
如 果 应 用 程序 运行 于 上 述 主 机 名 之 下 ， 那 么 ，Django 仅 为 该 应 用 程序 提供 服务 。 关 
于 所 支持 的 设置 内 容 ， 读 者 可 访问 https://docs.djangoproject.com/en/2.0/ref/settings/#allowed- 
hosts 以 了 解 更 多 内 容 。 


t 


件 
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13.1.10 ”向 静态 和 媒体 数据 集 提供 服务 


NGINX 擅长 于 向 静态 内 容 提 供 服 务 。 考 虑 到 最 佳 性 能 ， 我 们 将 使 用 NGINX 向 当前 
产品 环境 中 的 静态 文件 提供 服务 。 具 体 来 说 ， 将 设置 NGINX， 并 针对 应 用 程序 中 的 静态 
文件 ， 以 及 针对 课程 内 容 上 传 的 媒体 文件 提供 服务 。 

编辑 settings/base.py 文件 ， 并 向 其 中 添加 下 列 代码 : 

STATIC ROOT = os.path.join(BASE DIR, 'static/') 

我 们 需要 利用 Django 导出 静态 数据 集 。collectstatic 命令 将 复制 源 自 所 有 应 用 程序 的 
静态 文件 ， 并 将 其 存储 至 STATIC_ ROOT 目录 中 。 打 开 Shell 并 运行 下 列 命令 : 

Python manage.py collectstatic 

对 应 输出 结果 如 下 所 示 : 


160 static files copied to '/educa/static' . 


下 面 编 辑 config/nginx.conf 文件 ， 并 在 server 指令 中 添加 下 列 代码 : 
location /static/ { 
alias /home/projects/educa/static/; 
} 
location /media/ { 
alias /home/projects/educa/media/; 
. 
注意 ,此 处 需要 将 home/projects/educa/ 路 径 蔡 换 为 项 目 目录 的 绝对 路 径 。 此 类 命令 通 
知 NGINX 直接 向 位 于 /static/ 和 /media/ 路 径 下 的 静态 数据 集 提供 服务 。 相 关 路 径 包括 以 下 
方面 。 
口 /static/: 该 路 径 匹 配 于 STATIC _URL 设置 中 指定 的 路 径 ， 其 目标 路 径 对 应 于 
STATIC_ ROOT 设置 值 。 据 此 ， 可 向 当前 应 用 程序 的 静态 文件 提供 服务 。 
口 “/media/: 该 路 径 匹 配 于 MEDIA_URL 设置 中 指定 的 路 径 ， 其 目标 路 径 对 应 于 
MEDIA_ ROOT 设置 值 。 据 此 ， 可 向 上 传 至 课程 内 容 的 媒体 文件 提供 服务 。 
利用 下 列 命令 重 载 NGINX 的 配置 内 容 ， 并 记录 新 的 路 径 : 


service nginx reload 


在 浏览 器 中 打开 http://educaproject.com/， 此 时 , 站 点 可 正确 地 加 载 静 态 资 源 , 如 CSS 
样式 表 和 图 像 。NGINX 当前 直接 服务 于 静态 文件 ， 而 不 是 将 静态 文件 的 请 求 转发 至 
UWSGI。 
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至 此 ， 我 们 已 对 静态 文件 服务 成 功 地 配置 了 NGINX。 
13.1.11 基于 SSL 的 安全 连接 


安全 套 接 字 层 协议 〈SSL) 正成 为 通过 安全 连接 为 网 站 提供 服务 的 一 项 标准 。 这 里 ， 
强烈 建议 使 用 HTTPS 服务 于 网 站 。 我 们 将 在 NGINX 中 配置 一 个 SSL 证 书 来 安全 地 服务 
当前 站 点 。 

1. 创建 SSL 证 书 

在 educa 项 目 目录 中 生成 新 目录 ， 并 将 其 命名 为 ssl。 随 后 利用 下 列 命令 生成 SSL 证 书 : 


sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout 
ssl/educa.key -out ssl/educa.crt 


我 们 将 生成 一 个 主键 ， 以 及 一 个 2048 位 的 SSL 证 书 ， 其 有 效 期 为 1 年 。 此 时 ， 用户 
将 被 询问 输入 下 列 数据 ; 

Country Name (2 letter code) [AU] : 

State or Province Name (full name) [Some-State] : 

Locality Name (eg, city) []: 

Organization Name (eg, company) [Internet Widgits Pty Ltd] : 

Organizational Unit Name (eg, section) []: 

Common Name (e.g. server FQDN or YOUR name) []: educaproject.com 

Email Address []: email@domain.com 


用 户 可 利用 自身 的 信息 进行 填写 。 其 中 ， 较 为 重要 的 字段 是 Common Name。 另 外 ， 
还 需要 针对 证 书 指定 相应 的 域名 ， 此 处 采用 了 educaproject.com。 

这 将 在 ssl/ 目 录 中 生成 一 个 educa key 私 钥 文 件 ， 以 及 一 个 educa.crt 文件 ， 即 实际 的 
证 书 。 

2. 配置 NGINX 以 使 用 SSL 

编辑 nginx.conf 文件 ， 同 时 编辑 server 命令 并 包含 SSL， 如 下 所 示 : 


server { 
listen 80; 
listen 443 ssl; 
ssl certificate /home/projects/educa/ssl/educa.crt; 


ssl certificate key /home/projects/educa/ssl/educa.key; 
server name www.educaproject.com educaproject .com; 


bE 
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上 述 代码 ， 服 务 器 将 通过 80 端 


监听 HITP， 并 通过 443 端 


利 


显示 了 一 


取决 


受信 证 书 : 


而 不 是 从 受信 的 认证 机 构 〈CA) 获取 证 书 。 当 持 有 实际 域名 时 ， 可 使 


下 列 命令 重启 NGINX: 


sudo service nginx restart 


随后 ，NGINX 将 加 载 新 的 配置 内 容 。 在 浏览 器 中 打开 https://educaproject.com/。 图 13.2 


条 警告 消息 。 


This Connection is Untrusted 


监听 HTTPS。 这 


ssl_certificate 指定 SSL 证 书 的 路 径 ， 并 通过 ssl_certificate_key 指定 证 书 密 钥 。 


You have asked Firefox to connect securely to educaproject.com, but we can't confirm that your 


connectionis secure. 


Normally, when you try to connect securely, sites will present trusted identification to prove that you 
are going to the right place. However, this site’s identity can't be verified. 


What Should | Do? 


IFyou usually conrect to this site without problems, this error could mean that someone is trying to 


impersonate the site, and you shouldn 


Get me out of here! 
Technical Details 
l Understand the Risks 


YEcontinue. 


IFyou understand what's going on, you can tell Firefox to start trusting this site's identification. Even 
证 you trust the site, this error could mean that someone is tampering with your connection. 


Don't add an exception unless youknow there's a good reason why this site doesm't use trusted 


identification. 


Add Exception... 


图 13.2 


于 浏览 器 ， 上 述 消息 可 能 有 所 不 同 。 对 应 消息 内 容 提 醒 用 户 ， 


发 布 SSL 证 书 ， 以 使 浏览 器 可 对 相关 身份 进行 验证 。 


当前 站 点 未 使 用 


浏览 器 并 不 能 对 站 点 的 身份 进行 验证 ， 其 原因 在 于 ， 我 们 指定 了 自己 的 证 书 ， 


受信 的 CA 对 此 


如 果 希 望 针 对 实际 域名 获取 受信 证 书 ， 可 参考 Linux 基金 会 发 布 的 “Let's Encrypt” 


项 目 ， 这 是 一 个 旨 在 简化 免费 获取 和 更 新 可 信 SSL 证 书 的 协作 项 目 。 读 者 可 访问 
https://letsencrypt.org 以 了 解 更 多 信息 。 


到 一 个 锁 


HH 
Ett 


形 图 标 ， 如 图 13.3 所 示 。 


[CD educaprojectcom 


Ka 


图 标 时 ， 将 会 显示 SSL 证 二 


图 13.3 


所 的 详细 信息 。 


单 击 Add Exception 按钮 ， 并 告知 浏览 器 当前 信任 该 证 书 。 此 时 ， 在 URL 前 将 会 看 
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3. 针对 SSL 配置 项 目 

Django 针对 SSL 提供 了 特定 的 设置 内 容 。 编辑 settings/pro.py 文件 , 包 向 其 中 添加 下 
列 设置 内 容 : 

SECURE SSL REDIRECT = True 

CSRF COOKIE SECURE = True 

具体 内 容 解释 如 下 。 

口 SECURE SSL REDIRECT: HTTP 请 求 是 否 被 重 定向 至 HTTPS。 

口 CSRF_COOKIE_ SECURE: 为 跨 站 点 请 求 伪造 保护 设置 一 个 安全 Cookie。 

至 此 ， 我 们 配置 了 一 个 产品 环境 ， 同 时 提升 了 项 目 服务 的 性 能 。 


13.2 创建 自 定义 中 间 件 


前 述 内 容 已 讨论 了 MIDDLEWARE 设置 ， 其 中 涉及 项 目的 中 间 件 。 读 者 可 将 其 视 为 
-个 底层 插件 系统 ， 进 而 实现 在 请 求 /响应 过 程 中 执行 的 钩子 程序 。 其 中 ， 每 个 中 间 件 负 
责 特 定 的 操作 ， 并 针对 全 部 HITP 请 求 或 响应 予以 执行 。 


@ 注意， 


应 避免 向 中 间 件 中 添加 开销 较 大 的 处 理 过 程 一 一 中 间 件 执行 于 每 个 单一 请 求 中 。 


当 接收 一 个 HTTP 请 求 时 ， 中 间 件 将 以 MIDDLEWARE 设置 中 的 出 现 顺 序 被 执行 。 
当 Django 生成 HITP 响应 时 ， 该 响应 以 相反 的 顺序 通过 所 有 中 间 件 。 
中 间 件 可 编写 为 一 个 函数 ， 如 下 所 示 : 
def my middleware (get response): 
def middleware (request): 
# Code executed for each request before 
# the view (and later middleware) are called. 


response = get response (request) 


# Code executed for each request/response after 
# the view is called. 


return response 


return middleware 
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中 间 件 工厂 是 一 个 可 调用 对 象 , 接收 可 调用 的 get response 并 返回 一 个 中 间 件 。 可 调 
的 中 间 件 接收 一 个 请 求 ， 随 后 返回 一 个 响应 结果 ， 这 与 视图 较为 类 似 。 可 调用 的 
get_response 可 能 是 链 中 的 下 一 个 中 间 件 ， 也 可 能 是 最 后 列 出 的 中 间 件 的 实际 视图 。 
如 果 中 间 件 返回 一 个 响应 ， 且 未 调用 get_response， 则 处 理 过 程 将 会 处 于 “短路 ” 状 
态 ， 此 时 ， 不 会 再 有 中 间 件 被 执行 (同样 ， 视 图 也 不 会 被 执行 》， 响 应 结果 将 在 请 求 传 
入 的 同一 层 中 被 返回 。 

中 间 件 在 MIDDLEWARE 设置 中 的 顺序 十 分 重要 ， 因 为 中 间 件 依赖 于 之 前 执行 的 中 
间 件 请 求 中 的 数据 集 。 


@@ 注意 
在 向 MIDDLEWARE 设置 中 添加 新 的 中 间 件 时 ， 应 确保 将 其 置 于 正确 的 位 置 。 在 
请 求 阶段 ， 中 间 件 将 以 设置 中 的 顺序 被 执行 ; 而 在 响应 阶段 ， 则 以 相反 的 顺序 执行 。 


读者 可 访问 https://docs.djangoproject.com/en/2.0/topics/http/middleware/， 以 了 解 与 中 
间 件 相关 的 更 多 信息 。 


13.2.1 创建 子 域名 中 间 件 


本 节 将 创建 一 个 子 域名 中 间 件 ， 以 使 相关 课程 可 通过 一 个 自 定 义 的 子 域名 予以 访问 。 
另外 ， 每 门 课程 的 详细 URL， 形 如 https://educaproject.com/course/django/， 也 将 通过 子 域 
名 进行 访问 ， 其 中 使 用 到 了 课程 的 sug， 如 https://django.educaproject.com/。 用 户 可 将 子 
域名 视 为 一 种 快捷 方式 ， 进 而 访问 课程 的 细节 信息 。 任 何 子 域名 的 请 求 将 被 重 定向 至 对 
应 的 课程 详细 URL 处 。 

中 间 件 可 位 于 项 目 中 的 任何 位 置 。 尽 管 如 此 ， 这 里 依然 建议 在 应 用 程序 目录 中 创建 
一 个 middleware.py 文件 。 

在 courses 应 用 程序 目录 生成 一 个 新 文件 , 将 其 命名 为 middleware.py， 并 向 其 中 添加 
下 列 代码 : 

from django.urls import reverse 


from django.shortcuts import get object or 404, redirect 
from .models import Course 


def subdomain course middleware (get response): 


mnm 


Provides subdomains for courses 


mm 


def middleware (request) : 
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host parts = request.get host().split('.') 
if len(host parts) > 2 and host parts[0] != 'www': 
# get course for the given subdomain 
course = get object or 404(Course, slug=host parts[0]) 
course url = reverse('course detail', 
args=[course.slug]) 
# redirect current request to the course detail view 
url = "'{}://{}{}"'.format (request.scheme, 
YL partslisl)s 
course url) 
return redirect (url) 


response = get response (request) 
return response 


return middleware 


当 接 收 HTTP 请 求 时 ， 将 执行 下 列 各 项 任务 : 
(1) 获取 用 于 请 求 中 的 主机 名 ， 并 对 其 进行 划分 。 例 如 ， 如 果 用 户 访问 mycourse. 
educaprojectcom， 那 么 ， 将 会 生成 一 个 [mycourse', 'educaproject', 'com'] 列 表 
(2) 通过 检测 划分 结果 是 否 生 成 了 多 个 元 素 〈 大 于 2) ， 进 而 查看 主 机 名 是 否 外 
了 一 个 子 域名 。 若 主机 名 中 涵盖 了 一 个 子 域名 且 不 为 www, 则 尝试 利用 子 域名 提供 的 i 
获取 对 应 课程 。 
(3) 若 不 存在 相关 课程 ， 则 抛 出 404 异常 ， 否 则 ， 将 浏览 器 重 定向 至 课程 的 详细 
URL 处 。 
编辑 项 目的 settings.py 文件 ,并 在 MIDDLEWARE 列表 下 方 添加 'courses.middleware. 
SubdomainCourseMiddleware'， 如 下 所 示 : 
MIDDLEWARE = [ 
a 
] 
当前 ， 中 间 件 将 在 每 个 请 求 中 被 执行 。 
注意 ， 可 对 Django 项 目 提供 服务 的 主机 名 在 ALLOWED HOSTS 设置 中 被 指定 。 下 
面 尝试 修改 这 一 设置 内 容 ， 以 使 educaproject.com 的 子 域名 可 向 当前 应 用 程序 提供 服务 。 
编辑 settings/pro.py 文件 ， 并 调整 ALLOWED _HOSTS 设置 ， 如 下 所 示 : 


ALLOWED HOSTS 


['.educaproject.com'] 
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其 中 ， 以 点 号 开始 的 某 个 值 可 用 作 子 域名 通配符 。 具 体 来 说 ，'.educaprojectcom' 可 匹 
配 educaproject.com， 以 及 该 域名 的 任何 子 域名 ， 如 course.educaproject.com 和 django. 
educaproject.com。 


13.2.2 ”利用 NGINX 向 多 个 子 域名 提供 服务 


我 们 须 压迫 使 用 到 NGINX， 进 而 可 向 包含 任意 子 域名 的 站 点 提供 服务 。 对 此 ， 编 辑 
config/nginx.conf 文件 ， 并 查看 下 列 代码 行 : 


Server name www.educaproject.com educaproject.com; 
同时 将 其 葵 换 为 下 列 内 容 : 


server name *.educaproject.com educaproject.com; 


通过 使 用 星 号 ， 可 将 这 一 规则 应 用 于 educaproject.com 的 全 部 子 域名 上 。 当 对 中 间 件 
进行 本 地 测试 时 ， 需 要 向 /etc/hosts 添加 需要 测试 的 子 域名 。 当 利用 包含 slug django 的 
Course 对 象 测试 中 间 件 时 ， 应 向 /etc/hosts 文件 中 加 入 下 列 代码 行 : 


127.0.0.1 django.educaproject .com 


随后 ， 在 浏览 器 中 打开 https://django.educaproject.com/， 中 间 件 通过 当前 子 域名 可 发 
现 对 应 的 课程 ， 并 将 浏览 器 重 定向 至 https://educaproject.com/course/django/。 


13.3 ”实现 自 定义 管理 命令 


Django 可 使 应 用 程序 针对 manage.py 工具 注册 自 定义 管理 命令 。 例 如 ， 第 9 章 中 曾 
使 用 了 makemessages 和 compilemessages 管理 命令 创建 和 编译 翻译 文件 。 

管理 命令 由 Python 模块 构成 ， 其 中 包含 了 继承 自 django.core.management.base. 
BaseCommand (或 其 子 类 ) 的 Command 类 。 据 此 ， 可 以 创建 简单 的 命令 ， 或 者 令 其 接收 
位 置 参数 和 可 选 参数 作为 输入 内 容 。 

对 于 INSTALLED APPS 设置 中 处 于 活动 状态 的 每 个 应 用 程序 ，Django 查找 
management/commands/ 目 录 中 的 管理 命令 ， 所 找到 的 每 个 模块 都 注册 为 一 个 以 其 命名 的 
管理 命令 。 

读者 可 访问 https://docs.djangoproject.com/en/2.0/howto/custom-management-commands/， 
进而 了 解 与 自 定义 管理 命令 相关 的 更 多 内 容 。 

下 面 创建 一 个 自 定义 命令 ， 以 此 提示 学 生 至 少 应 注册 一 门 课程 。 该 命令 将 向 注册 时 
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间 超 过 指定 时 间 但 尚未 注册 的 用 户 发 送 电子 邮件 提示 信息 。 
在 students 应 用 程序 目录 中 生成 下 列 文件 结构 
management/ 

nit -py 
commands/ 
i pv 


enroll reminder.py 


编辑 enroll reminder.py 文件 ， 并 向 其 中 添加 下 列 代 码 : 


import datetime 


from django 
from django 
from django. 
from django. 
from django 


class Comman 
help = " 


-Conf import settings 
.Core.management .base import BaseCommand 


core.mail import send mass mail 
contrib.auth.models import User 


.db.models import Count 


d(BaseCommand): 
Sends an e-mail reminder to users registered more \ 


than N days that are not enrolled into any courses yet' 


def add 


arguments (self, parser): 


parser.add argument ('--days', dest='days', type=int) 


def hand 


le(self, *args, **options): 


emails = [] 


subj 
date 
date 


ect = "Enroll in a course' 
joined = datetime.date.today() - \ 
time.timedelta (days=options['days']) 


users = 


User.objects 
Ee 
for 


send 
Self 


.annotate (course count=Count('courses joined'))\ 
ter (course count=0, date joined lte=date joined) 
user in users: 
message = 'Dear {},\n\n We noticed that you didn't\ 
enroll in any courses yet. What are you waiting\ 
for?' .format (user.first name) 
emails.append( (subject, 
message, 
settings.DEFAULT FROM EMAIL, 
[user.email])) 
mass mail (emails) 
.stdout.write('Sent {} reminders' .format (len (emails))) 


.428 。 


Django 项 目 实例 精 解 〈 第 2 版 


上 述 代码 定义 了 enroll reminder 命令 ， 具 体 解释 如 下 : 


口 
加 


口 


Command 类 继承 自 BaseCommand。 

此 处 包含 了 一 个 help 属性 .如 果 运 行 python manage.py help enroll reminder 命令 ， 
help 属性 将 提供 一 个 该 命令 的 简短 描述 。 

使 用 add_arguments() 方 法 并 添加 一 个 --days 命名 参数 。 对 于 尚未 注册 任何 课程 的 
和 户 ， 该 参数 用 于 指定 用 户 须 注册 的 最 少 天 数 ， 以 便 接 收 提示 信息 。 
handle(0) 命 令 包含 了 实际 的 命令 。 我们 可 得 到 解析 自命 令 行 的 days 属性 ， 进 而 检 
索 已 经 超过 指定 日 期 的 注册 用 户 ， 这 些 用 户 还 没有 注册 任何 课程 。 对 此 ， 可 通 
过 每 个 用 户 注 册 的 课程 总 数 来 注解 QuerySet。 随 后 ， 针 对 每 一 名 用 户 生成 提示 
邮件 ， 并 将 其 附加 至 emails 列表 中 。 最 后 ， 利 用 send_mass_mail0 函 数 发 送 电子 
邮件 ， 该 操作 被 优化 为 : 针对 所 有 邮件 开启 单一 的 SMTP 连接 ， 而 不 是 针对 每 
封 所 发 送 的 邮件 开启 一 个 连接 。 


至 此 ， 我 们 生成 了 第 一 个 管理 命令 。 接 下 来 ， 打 开 Shell 并 运行 下 列 命令 : 

Python manage.PY enroll reminder --days=20 

如 果 尚 未 设置 SMTP 本 地 服务 器 ， 可 参考 第 2 章 中 的 相关 内 容 ， 其 中 针对 本 书 第 一 
个 项 目 配置 了 SMTP 设置 。 除 此 之 外 ， 还 可 向 settings.py 文件 中 添加 下 列 设置 内 容 ， 以 
使 Django 在 开发 阶段 向 标准 输出 中 显示 电子 邮件 。 


EMAIL BACKEND = "django.core.mail.backends.console.EmailBackend' 


Fi 


i 尝试 对 管理 命令 进行 调度 ， 以 使 服务 器 在 每 天 上 午 8 点 运行 该 命令 。 如 果 读 者 


正在 使 用 基于 UNIX 的 操作 系统 ， 如 Linux 或 macOS X， 可 打开 Shell 并 运行 crontab-e， 
以 对 crontab 进行 编辑 。 对 此 ， 可 添加 下 列 代码 行 : 


0 


8 * * * Python /path/to/educa/manage.py enroll reminder --days=20 


--settings=educa.settings.pro 


如 果 读 者 对 cron 尚 不 熟悉 ， 可 访问 http://www.unixgeeks.org/security/newbie/unix/ 
cron-1.html， 并 查看 与 cron 相关 的 文档 。 

对 于 Windows 环境 , 可 通过 Task Scheduler 对 任务 进行 调度 。 读 者 可 访问 https://msdn. 
microsoft.com/en-us/library/windows/desktop/aa383614(v=vs.85).aspx， 以 了 解 Task Scheduler 


方面 的 信 
除 


Celery 执行 异步 任务 。 此 处 并 不 打算 创建 管理 命令 , 并 采用 cron 对 其 进行 调度 ， 相应 地 ， 


宫 息 。 


瑟 心 


之 外 ， 另 一 种 定期 执行 任务 的 方法 则 是 使 用 Celery。 回 忆 一 下 ， 第 7 章 曾 使 用 


可 利用 Celery 调度 器 创建 异步 任务 ， 并 对 其 加 以 执行 。 关 于 Celery 周期 性 任务 调度 ， 读 


第 13 章 部 署 项 目 “429 。 


者 可 访问 https://celery.readthedocs.io/en/latest/userguide/periodic-tasks.html 以 了 解 更 多 内 容 。 
©@ :i§: 
对 于 希望 用 cron 或 Windows 调度 器 控制 面板 调度 的 独立 脚本 ， 可 以 使 用 管理 命令 。 
Django 还 内 置 了 一 个 工具 ， 并 可 通过 Python 调用 管理 命令 。 我 们 可 通过 下 列 方式 运 
行 代 码 中 的 管理 命 


from django .core import management 
management .call command(" enroll reminder ', days=20) 


至 此 ， 我 们 已 针对 应 用 程序 创建 了 自 定义 命令 ， 并 可 在 必要 时 对 其 加 以 调度 。 


13.4 本 章 小结 


本 章 通过 uWSGI 和 NGINX 配置 了 产品 环境 。 除 此 之 外 ， 还 实现 了 自 定义 中 间 件 ， 
以 及 如 何 创建 自 定义 管理 命令 。 

阅读 至 此 ， 本 书 内 容 已 接近 尾声 。 恭 嘉 您 ! 您 已 经 学 习 了 使 用 Django 构建 Web 应 用 
旦 序 所 需 的 技能 ， 并 以 此 开发 真实 的 项 目 ， 将 Django 与 其 他 技术 集成 在 一 起 。 无 论 是 简 
单 的 原型 还 是 大 型 的 Web 应 用 程序 ， 读 者 已 经 可 以 着 手 开发 自己 的 Django 项 目 了 。 

让 我 们 共同 期 待 下 一 次 的 Django 冒险 ， 视 好 运 ! 


